@@ -25,29 +25,25 @@ import "google/protobuf/field_mask.proto";
2525import "google/shopping/merchant/products/v1beta/products_common.proto" ;
2626import "google/shopping/type/types.proto" ;
2727
28- option csharp_namespace = "Google.Shopping.Merchant.Products.V1Beta" ;
2928option go_package = "cloud.google.com/go/shopping/merchant/products/apiv1beta/productspb;productspb" ;
3029option java_multiple_files = true ;
3130option java_outer_classname = "ProductInputsProto" ;
3231option java_package = "com.google.shopping.merchant.products.v1beta" ;
33- option php_namespace = "Google\\Shopping\\Merchant\\Products\\V1beta" ;
34- option ruby_package = "Google::Shopping::Merchant::Products::V1beta" ;
3532
3633// Service to use ProductInput resource.
34+ // This service works for products with online channel only.
3735service ProductInputsService {
3836option (google.api.default_host ) = "merchantapi.googleapis.com" ;
3937option (google.api.oauth_scopes ) = "https://www.googleapis.com/auth/content" ;
4038
4139// [Uploads a product input to your Merchant Center
42- // account](/merchant/api/guides/products/add-manage#add_a_product). You
43- // must have a products [data
44- // source](/merchant/api/guides/data-sources/api-sources#create-primary-data-source)
45- // to be able to insert a product. The unique identifier of the data source is
46- // passed as a query parameter in the request URL.
40+ // account](/merchant/api/guides/products/overview#upload-product-input). You
41+ // must have a products data source to be able to insert a product. The unique
42+ // identifier of the data source is passed as a query parameter in the request
43+ // URL.
4744//
48- // If a product input with the same contentLanguage, offerId, and dataSource
49- // already exists, then the product input inserted by this method replaces
50- // that entry.
45+ // If an input with the same contentLanguage, offerId, and dataSource already
46+ // exists, this method replaces that entry.
5147//
5248// After inserting, updating, or deleting a product input, it may take several
5349// minutes before the processed product can be retrieved.
@@ -119,14 +115,10 @@ message ProductInput {
119115
120116// Identifier. The name of the product input.
121117// Format: `accounts/{account}/productInputs/{productinput}`
122- // where the last section `productinput` consists of:
123- // `content_language~feed_label~offer_id`
118+ // where the last section `productinput` consists of 4 parts :
119+ // `channel~ content_language~feed_label~offer_id`
124120// example for product input name is
125- // `accounts/123/productInputs/en~US~sku123`. A legacy local product input
126- // name would be `accounts/123/productInputs/local~en~US~sku123`.
127- // Note: For calls to the v1beta version, the `productInput` section consists
128- // of: `channel~content_language~feed_label~offer_id`, for example:
129- // `accounts/123/productInputs/online~en~US~sku123`.
121+ // `accounts/123/productInputs/online~en~US~sku123`
130122string name = 1 [(google.api.field_behavior ) =IDENTIFIER ];
131123
132124// Output only. The name of the processed product.
@@ -158,8 +150,8 @@ message ProductInput {
158150(google.api.field_behavior ) =IMMUTABLE
159151 ];
160152
161- // Required. Immutable. Thefeed label that lets you categorize and identify
162- //your products. The maximum allowed characters are 20, and the supported
153+ // Required. Immutable. The label that lets you categorize and identify your
154+ // products. The maximum allowed characters are 20, and the supported
163155// characters are `A-Z`, `0-9`, hyphen, and underscore. The feed label must
164156// not include any spaces. For more information, see [Using feed
165157// labels](//support.google.com/merchants/answer/14994087).
@@ -223,8 +215,8 @@ message InsertProductInputRequest {
223215// Required. The primary or supplemental product data source name. If the
224216// product already exists and data source provided is different, then the
225217// product will be moved to a new data source. For more information, see
226- // [Create a primary data
227- //source ](/merchant/api/guides/data-sources/api-sources#create-primary-data-source ).
218+ // [Overview of Data sources
219+ //sub-API ](/merchant/api/guides/data-sources/overview ).
228220//
229221// Only API data sources are supported.
230222//
@@ -268,30 +260,16 @@ message UpdateProductInputRequest {
268260// Format: `accounts/{account}/dataSources/{datasource}`. For example,
269261// `accounts/123456/dataSources/104628`.
270262string data_source = 3 [(google.api.field_behavior ) =REQUIRED ];
271-
272- // Optional. If true, the `{productInput}` in the `name` field of the request
273- // will be interpreted as unpadded base64url-encoded and decoded during
274- // request processing to match the decoded value. Default value is `false`.
275- // Use this if your `{productInput}` contains special characters, such as
276- // forward slash
277- // `/` or other characters that are unpadded base64url-encoded (as per RFC
278- // 7515: https://datatracker.ietf.org/doc/html/rfc7515#section-2).
279- //
280- // Note that future versions of the API will only accept unpadded
281- // base64url-encoded product ids, so we strongly recommend proactively setting
282- // this to `true` and encoding the product ids.
283- bool product_id_base64_url_encoded = 4
284- [(google.api.field_behavior ) =OPTIONAL ];
285263}
286264
287265// Request message for the DeleteProductInput method.
288266message DeleteProductInputRequest {
289267// Required. The name of the product input resource to delete.
290268// Format: `accounts/{account}/productInputs/{product}`
291- // where the last section `product` consists of:
292- // `content_language~feed_label~offer_id`
269+ // where the last section `product` consists of 4 parts :
270+ // `channel~ content_language~feed_label~offer_id`
293271// example for product name is
294- // `accounts/123/productInputs/en~US~sku123`.
272+ // `accounts/123/productInputs/online~ en~US~sku123`.
295273string name = 1 [
296274(google.api.field_behavior ) =REQUIRED ,
297275(google.api.resource_reference ) = {
@@ -304,18 +282,4 @@ message DeleteProductInputRequest {
304282// `accounts/{account}/dataSources/{datasource}`. For example,
305283// `accounts/123456/dataSources/104628`.
306284string data_source = 2 [(google.api.field_behavior ) =REQUIRED ];
307-
308- // Optional. If true, the `{productInput}` in the `name` field of the request
309- // will be interpreted as unpadded base64url-encoded and decoded during
310- // request processing to match the decoded value. Default value is `false`.
311- // Use this if your `{productInput}` contains special characters, such as
312- // forward slash
313- // `/` or other characters that are unpadded base64url-encoded (as per RFC
314- // 7515: https://datatracker.ietf.org/doc/html/rfc7515#section-2).
315- //
316- // Note that future versions of the API will only accept unpadded
317- // base64url-encoded product ids, so we strongly recommend proactively setting
318- // this to `true` and encoding the product ids.
319- bool product_id_base64_url_encoded = 3
320- [(google.api.field_behavior ) =OPTIONAL ];
321285}