@googleapis/merchantapi 10.1.0 → 11.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,21 @@
1
1
  # Changelog
2
2
 
3
+ ## [11.0.0](https://github.com/googleapis/google-api-nodejs-client/compare/merchantapi-v10.1.0...merchantapi-v11.0.0) (2025-08-04)
4
+
5
+
6
+ ### ⚠ BREAKING CHANGES
7
+
8
+ * **merchantapi:** This release has breaking changes.
9
+
10
+ ### Features
11
+
12
+ * **merchantapi:** update the API ([daa4e02](https://github.com/googleapis/google-api-nodejs-client/commit/daa4e02f0f31eb5dc9499d2723fb3e2d8d1979cf))
13
+
14
+
15
+ ### Bug Fixes
16
+
17
+ * **merchantapi:** update the API ([117a719](https://github.com/googleapis/google-api-nodejs-client/commit/117a719096e9a5f77a46681c8d9216beb3580bfa))
18
+
3
19
  ## [10.1.0](https://github.com/googleapis/google-api-nodejs-client/compare/merchantapi-v10.0.0...merchantapi-v10.1.0) (2025-07-25)
4
20
 
5
21
 
@@ -140,7 +140,7 @@ export namespace merchantapi_accounts_v1beta {
140
140
  uri?: string | null;
141
141
  }
142
142
  /**
143
- * Describes the [accepted terms of service](/merchant/api/guides/accounts/create-and-configure#accept_the_merchant_center_terms_of_service).
143
+ * Describes the [accepted terms of service](https://developers.google.com/merchant/api/guides/accounts/create-and-configure#accept_the_merchant_center_terms_of_service).
144
144
  */
145
145
  export interface Schema$Accepted {
146
146
  /**
@@ -566,7 +566,7 @@ export namespace merchantapi_accounts_v1beta {
566
566
  */
567
567
  effectiveUriSettings?: Schema$UriSettings;
568
568
  /**
569
- * Optional. The destinations to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS`
569
+ * Optional. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS`
570
570
  */
571
571
  eligibleDestinations?: string[] | null;
572
572
  /**
@@ -2130,7 +2130,7 @@ export namespace merchantapi_accounts_v1beta {
2130
2130
  */
2131
2131
  carrierService?: string | null;
2132
2132
  /**
2133
- * Required. Warehouse name. This should match [warehouse](/merchant/api/reference/rest/accounts_v1beta/accounts.shippingSettings#warehouse)
2133
+ * Required. Warehouse name. This should match warehouse.
2134
2134
  */
2135
2135
  warehouse?: string | null;
2136
2136
  }
@@ -86,7 +86,7 @@ export declare namespace merchantapi_accounts_v1beta {
86
86
  uri?: string | null;
87
87
  }
88
88
  /**
89
- * Describes the [accepted terms of service](/merchant/api/guides/accounts/create-and-configure#accept_the_merchant_center_terms_of_service).
89
+ * Describes the [accepted terms of service](https://developers.google.com/merchant/api/guides/accounts/create-and-configure#accept_the_merchant_center_terms_of_service).
90
90
  */
91
91
  export interface Schema$Accepted {
92
92
  /**
@@ -516,7 +516,7 @@ export declare namespace merchantapi_accounts_v1beta {
516
516
  */
517
517
  effectiveUriSettings?: Schema$UriSettings;
518
518
  /**
519
- * Optional. The destinations to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS`
519
+ * Optional. The destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) to which the checkout program applies, valid destination values are `SHOPPING_ADS`, `FREE_LISTINGS`
520
520
  */
521
521
  eligibleDestinations?: string[] | null;
522
522
  /**
@@ -2089,7 +2089,7 @@ export declare namespace merchantapi_accounts_v1beta {
2089
2089
  */
2090
2090
  carrierService?: string | null;
2091
2091
  /**
2092
- * Required. Warehouse name. This should match [warehouse](/merchant/api/reference/rest/accounts_v1beta/accounts.shippingSettings#warehouse)
2092
+ * Required. Warehouse name. This should match warehouse.
2093
2093
  */
2094
2094
  warehouse?: string | null;
2095
2095
  }
@@ -165,7 +165,7 @@ export declare namespace merchantapi_inventories_v1beta {
165
165
  */
166
166
  pickupSla?: string | null;
167
167
  /**
168
- * Price of the product at this store.
168
+ * Optional. Price of the product at this store.
169
169
  */
170
170
  price?: Schema$Price;
171
171
  /**
@@ -173,11 +173,11 @@ export declare namespace merchantapi_inventories_v1beta {
173
173
  */
174
174
  quantity?: string | null;
175
175
  /**
176
- * Sale price of the product at this store. Mandatory if `salePriceEffectiveDate` is defined.
176
+ * Optional. Sale price of the product at this store. Mandatory if `salePriceEffectiveDate` is defined.
177
177
  */
178
178
  salePrice?: Schema$Price;
179
179
  /**
180
- * The `TimePeriod` of the sale at this store.
180
+ * Optional. The `TimePeriod` of the sale at this store.
181
181
  */
182
182
  salePriceEffectiveDate?: Schema$Interval;
183
183
  /**
@@ -281,7 +281,7 @@ export declare namespace merchantapi_inventories_v1beta {
281
281
  */
282
282
  name?: string | null;
283
283
  /**
284
- * Price of the product in this region.
284
+ * Optional. Price of the product in this region.
285
285
  */
286
286
  price?: Schema$Price;
287
287
  /**
@@ -289,11 +289,11 @@ export declare namespace merchantapi_inventories_v1beta {
289
289
  */
290
290
  region?: string | null;
291
291
  /**
292
- * Sale price of the product in this region. Mandatory if `salePriceEffectiveDate` is defined.
292
+ * Optional. Sale price of the product in this region. Mandatory if `salePriceEffectiveDate` is defined.
293
293
  */
294
294
  salePrice?: Schema$Price;
295
295
  /**
296
- * The `TimePeriod` of the sale price in this region.
296
+ * Optional. The `TimePeriod` of the sale price in this region.
297
297
  */
298
298
  salePriceEffectiveDate?: Schema$Interval;
299
299
  }
@@ -346,7 +346,7 @@ export declare namespace merchantapi_ordertracking_v1beta {
346
346
  }
347
347
  export class Resource$Accounts {
348
348
  context: APIRequestContext;
349
- ordertrackingsignals: Resource$Accounts$Ordertrackingsignals;
349
+ orderTrackingSignals: Resource$Accounts$Ordertrackingsignals;
350
350
  constructor(context: APIRequestContext);
351
351
  }
352
352
  export class Resource$Accounts$Ordertrackingsignals {
@@ -382,7 +382,7 @@ export declare namespace merchantapi_ordertracking_v1beta {
382
382
  * google.options({auth: authClient});
383
383
  *
384
384
  * // Do the magic
385
- * const res = await merchantapi.accounts.ordertrackingsignals.create({
385
+ * const res = await merchantapi.accounts.orderTrackingSignals.create({
386
386
  * // Output only. The ID that uniquely identifies this order tracking signal.
387
387
  * orderTrackingSignalId: 'placeholder-value',
388
388
  * // Required. The account of the business for which the order signal is created. Format: accounts/{account\}
@@ -45,7 +45,7 @@ var merchantapi_ordertracking_v1beta;
45
45
  class Resource$Accounts {
46
46
  constructor(context) {
47
47
  this.context = context;
48
- this.ordertrackingsignals = new Resource$Accounts$Ordertrackingsignals(this.context);
48
+ this.orderTrackingSignals = new Resource$Accounts$Ordertrackingsignals(this.context);
49
49
  }
50
50
  }
51
51
  merchantapi_ordertracking_v1beta.Resource$Accounts = Resource$Accounts;
@@ -69,7 +69,7 @@ var merchantapi_ordertracking_v1beta;
69
69
  const rootUrl = options.rootUrl || 'https://merchantapi.googleapis.com/';
70
70
  const parameters = {
71
71
  options: Object.assign({
72
- url: (rootUrl + '/ordertracking/v1beta/{+parent}/ordertrackingsignals').replace(/([^:]\/)\/+/g, '$1'),
72
+ url: (rootUrl + '/ordertracking/v1beta/{+parent}/orderTrackingSignals').replace(/([^:]\/)\/+/g, '$1'),
73
73
  method: 'POST',
74
74
  apiVersion: '',
75
75
  }, options),
@@ -192,7 +192,7 @@ export declare namespace merchantapi_products_v1beta {
192
192
  */
193
193
  energyEfficiencyClass?: string | null;
194
194
  /**
195
- * The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center). For more information, see [Excluded destination](https://support.google.com/merchants/answer/6324486). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
195
+ * Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections. The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center). For more information, see [Excluded destination](https://support.google.com/merchants/answer/6324486). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
196
196
  */
197
197
  excludedDestinations?: string[] | null;
198
198
  /**
@@ -232,7 +232,7 @@ export declare namespace merchantapi_products_v1beta {
232
232
  */
233
233
  imageLink?: string | null;
234
234
  /**
235
- * The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in `excludedDestinations`. For more information, see [Included destination](https://support.google.com/merchants/answer/7501026). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
235
+ * Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections. The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in `excludedDestinations`. For more information, see [Included destination](https://support.google.com/merchants/answer/7501026). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
236
236
  */
237
237
  includedDestinations?: string[] | null;
238
238
  /**
@@ -771,7 +771,7 @@ export declare namespace merchantapi_products_v1beta {
771
771
  */
772
772
  feedLabel?: string | null;
773
773
  /**
774
- * The name of the product. Format: `accounts/{account\}/products/{product\}` where the last section `product` consists of 4 parts: `channel~content_language~feed_label~offer_id` example for product name is `accounts/123/products/online~en~US~sku123`
774
+ * The name of the product. Format: `accounts/{account\}/products/{product\}` where the last section `product` consists of: `content_language~feed_label~offer_id` example for product name is `accounts/123/products/en~US~sku123`. A legacy local product name would be `accounts/123/products/local~en~US~sku123`. Note: For calls to the v1beta version, the `product` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/products/online~en~US~sku123`.
775
775
  */
776
776
  name?: string | null;
777
777
  /**
@@ -863,7 +863,7 @@ export declare namespace merchantapi_products_v1beta {
863
863
  */
864
864
  feedLabel?: string | null;
865
865
  /**
866
- * Identifier. The name of the product input. Format: `accounts/{account\}/productInputs/{productinput\}` where the last section `productinput` consists of 4 parts: `channel~content_language~feed_label~offer_id` example for product input name is `accounts/123/productInputs/online~en~US~sku123`
866
+ * Identifier. The name of the product input. Format: `accounts/{account\}/productInputs/{productinput\}` where the last section `productinput` consists of: `content_language~feed_label~offer_id` example for product input name is `accounts/123/productInputs/en~US~sku123`. A legacy local product input name would be `accounts/123/productInputs/local~en~US~sku123`. Note: For calls to the v1beta version, the `productInput` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/productInputs/online~en~US~sku123`.
867
867
  */
868
868
  name?: string | null;
869
869
  /**
@@ -1190,7 +1190,7 @@ export declare namespace merchantapi_products_v1beta {
1190
1190
  * const res = await merchantapi.accounts.productInputs.delete({
1191
1191
  * // Required. The primary or supplemental data source from which the product input should be deleted. Format: `accounts/{account\}/dataSources/{datasource\}`. For example, `accounts/123456/dataSources/104628`.
1192
1192
  * dataSource: 'placeholder-value',
1193
- * // Required. The name of the product input resource to delete. Format: `accounts/{account\}/productInputs/{product\}` where the last section `product` consists of 4 parts: `channel~content_language~feed_label~offer_id` example for product name is `accounts/123/productInputs/online~en~US~sku123`.
1193
+ * // Required. The name of the product input resource to delete. Format: `accounts/{account\}/productInputs/{product\}` where the last section `product` consists of: `content_language~feed_label~offer_id` example for product name is `accounts/123/productInputs/en~US~sku123`.
1194
1194
  * name: 'accounts/my-account/productInputs/my-productInput',
1195
1195
  * });
1196
1196
  * console.log(res.data);
@@ -1336,7 +1336,7 @@ export declare namespace merchantapi_products_v1beta {
1336
1336
  * const res = await merchantapi.accounts.productInputs.patch({
1337
1337
  * // Required. The primary or supplemental product data source where `data_source` name identifies the product input to be updated. Only API data sources are supported. Format: `accounts/{account\}/dataSources/{datasource\}`. For example, `accounts/123456/dataSources/104628`.
1338
1338
  * dataSource: 'placeholder-value',
1339
- * // Identifier. The name of the product input. Format: `accounts/{account\}/productInputs/{productinput\}` where the last section `productinput` consists of 4 parts: `channel~content_language~feed_label~offer_id` example for product input name is `accounts/123/productInputs/online~en~US~sku123`
1339
+ * // Identifier. The name of the product input. Format: `accounts/{account\}/productInputs/{productinput\}` where the last section `productinput` consists of: `content_language~feed_label~offer_id` example for product input name is `accounts/123/productInputs/en~US~sku123`. A legacy local product input name would be `accounts/123/productInputs/local~en~US~sku123`. Note: For calls to the v1beta version, the `productInput` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/productInputs/online~en~US~sku123`.
1340
1340
  * name: 'accounts/my-account/productInputs/my-productInput',
1341
1341
  * // Optional. The list of product attributes to be updated. If the update mask is omitted, then it is treated as implied field mask equivalent to all fields that are populated (have a non-empty value). Attributes specified in the update mask without a value specified in the body will be deleted from the product. Update mask can only be specified for top level fields in attributes and custom attributes. To specify the update mask for custom attributes you need to add the `custom_attribute.` prefix. Providing special "*" value for full product replacement is not supported.
1342
1342
  * updateMask: 'placeholder-value',
@@ -1398,7 +1398,7 @@ export declare namespace merchantapi_products_v1beta {
1398
1398
  */
1399
1399
  dataSource?: string;
1400
1400
  /**
1401
- * Required. The name of the product input resource to delete. Format: `accounts/{account\}/productInputs/{product\}` where the last section `product` consists of 4 parts: `channel~content_language~feed_label~offer_id` example for product name is `accounts/123/productInputs/online~en~US~sku123`.
1401
+ * Required. The name of the product input resource to delete. Format: `accounts/{account\}/productInputs/{product\}` where the last section `product` consists of: `content_language~feed_label~offer_id` example for product name is `accounts/123/productInputs/en~US~sku123`.
1402
1402
  */
1403
1403
  name?: string;
1404
1404
  }
@@ -1422,7 +1422,7 @@ export declare namespace merchantapi_products_v1beta {
1422
1422
  */
1423
1423
  dataSource?: string;
1424
1424
  /**
1425
- * Identifier. The name of the product input. Format: `accounts/{account\}/productInputs/{productinput\}` where the last section `productinput` consists of 4 parts: `channel~content_language~feed_label~offer_id` example for product input name is `accounts/123/productInputs/online~en~US~sku123`
1425
+ * Identifier. The name of the product input. Format: `accounts/{account\}/productInputs/{productinput\}` where the last section `productinput` consists of: `content_language~feed_label~offer_id` example for product input name is `accounts/123/productInputs/en~US~sku123`. A legacy local product input name would be `accounts/123/productInputs/local~en~US~sku123`. Note: For calls to the v1beta version, the `productInput` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/productInputs/online~en~US~sku123`.
1426
1426
  */
1427
1427
  name?: string;
1428
1428
  /**
@@ -1468,7 +1468,7 @@ export declare namespace merchantapi_products_v1beta {
1468
1468
  *
1469
1469
  * // Do the magic
1470
1470
  * const res = await merchantapi.accounts.products.get({
1471
- * // Required. The name of the product to retrieve. Format: `accounts/{account\}/products/{product\}` where the last section `product` consists of 4 parts: `channel~content_language~feed_label~offer_id` example for product name is `accounts/123/products/online~en~US~sku123`
1471
+ * // Required. The name of the product to retrieve. Format: `accounts/{account\}/products/{product\}` where the last section `product` consists of: `content_language~feed_label~offer_id` example for product name is `accounts/123/products/en~US~sku123`. A legacy local product name would be `accounts/123/products/local~en~US~sku123`. Note: For calls to the v1beta version, the `product` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/products/online~en~US~sku123`.
1472
1472
  * name: 'accounts/my-account/products/my-product',
1473
1473
  * });
1474
1474
  * console.log(res.data);
@@ -1575,7 +1575,7 @@ export declare namespace merchantapi_products_v1beta {
1575
1575
  }
1576
1576
  export interface Params$Resource$Accounts$Products$Get extends StandardParameters {
1577
1577
  /**
1578
- * Required. The name of the product to retrieve. Format: `accounts/{account\}/products/{product\}` where the last section `product` consists of 4 parts: `channel~content_language~feed_label~offer_id` example for product name is `accounts/123/products/online~en~US~sku123`
1578
+ * Required. The name of the product to retrieve. Format: `accounts/{account\}/products/{product\}` where the last section `product` consists of: `content_language~feed_label~offer_id` example for product name is `accounts/123/products/en~US~sku123`. A legacy local product name would be `accounts/123/products/local~en~US~sku123`. Note: For calls to the v1beta version, the `product` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/products/online~en~US~sku123`.
1579
1579
  */
1580
1580
  name?: string;
1581
1581
  }
@@ -165,7 +165,7 @@ export declare namespace merchantapi_promotions_v1beta {
165
165
  */
166
166
  productTypeInclusion?: string[] | null;
167
167
  /**
168
- * Required. The list of destinations where the promotion applies to. If you don't specify a destination by including a supported value in your data source, your promotion will display in Shopping ads and free listings by default. You may have previously submitted the following values as destinations for your products: Shopping Actions, Surfaces across Google, Local surfaces across Google. To represent these values use `FREE_LISTINGS`, `FREE_LOCAL_LISTINGS`, `LOCAL_INVENTORY_ADS`. For more details see [Promotion destination](https://support.google.com/merchants/answer/13837465?sjid=5155774230887277618-NC)
168
+ * Required. The list of destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) where the promotion applies to. If you don't specify a destination by including a supported value in your data source, your promotion will display in Shopping ads and free listings by default. You may have previously submitted the following values as destinations for your products: Shopping Actions, Surfaces across Google, Local surfaces across Google. To represent these values use `FREE_LISTINGS`, `FREE_LOCAL_LISTINGS`, `LOCAL_INVENTORY_ADS`. For more details see [Promotion destination](https://support.google.com/merchants/answer/13837465?sjid=5155774230887277618-NC)
169
169
  */
170
170
  promotionDestinations?: string[] | null;
171
171
  /**
@@ -217,7 +217,7 @@ export namespace merchantapi_inventories_v1beta {
217
217
  */
218
218
  pickupSla?: string | null;
219
219
  /**
220
- * Price of the product at this store.
220
+ * Optional. Price of the product at this store.
221
221
  */
222
222
  price?: Schema$Price;
223
223
  /**
@@ -225,11 +225,11 @@ export namespace merchantapi_inventories_v1beta {
225
225
  */
226
226
  quantity?: string | null;
227
227
  /**
228
- * Sale price of the product at this store. Mandatory if `salePriceEffectiveDate` is defined.
228
+ * Optional. Sale price of the product at this store. Mandatory if `salePriceEffectiveDate` is defined.
229
229
  */
230
230
  salePrice?: Schema$Price;
231
231
  /**
232
- * The `TimePeriod` of the sale at this store.
232
+ * Optional. The `TimePeriod` of the sale at this store.
233
233
  */
234
234
  salePriceEffectiveDate?: Schema$Interval;
235
235
  /**
@@ -333,7 +333,7 @@ export namespace merchantapi_inventories_v1beta {
333
333
  */
334
334
  name?: string | null;
335
335
  /**
336
- * Price of the product in this region.
336
+ * Optional. Price of the product in this region.
337
337
  */
338
338
  price?: Schema$Price;
339
339
  /**
@@ -341,11 +341,11 @@ export namespace merchantapi_inventories_v1beta {
341
341
  */
342
342
  region?: string | null;
343
343
  /**
344
- * Sale price of the product in this region. Mandatory if `salePriceEffectiveDate` is defined.
344
+ * Optional. Sale price of the product in this region. Mandatory if `salePriceEffectiveDate` is defined.
345
345
  */
346
346
  salePrice?: Schema$Price;
347
347
  /**
348
- * The `TimePeriod` of the sale price in this region.
348
+ * Optional. The `TimePeriod` of the sale price in this region.
349
349
  */
350
350
  salePriceEffectiveDate?: Schema$Interval;
351
351
  }
@@ -400,10 +400,10 @@ export namespace merchantapi_ordertracking_v1beta {
400
400
 
401
401
  export class Resource$Accounts {
402
402
  context: APIRequestContext;
403
- ordertrackingsignals: Resource$Accounts$Ordertrackingsignals;
403
+ orderTrackingSignals: Resource$Accounts$Ordertrackingsignals;
404
404
  constructor(context: APIRequestContext) {
405
405
  this.context = context;
406
- this.ordertrackingsignals = new Resource$Accounts$Ordertrackingsignals(
406
+ this.orderTrackingSignals = new Resource$Accounts$Ordertrackingsignals(
407
407
  this.context
408
408
  );
409
409
  }
@@ -445,7 +445,7 @@ export namespace merchantapi_ordertracking_v1beta {
445
445
  * google.options({auth: authClient});
446
446
  *
447
447
  * // Do the magic
448
- * const res = await merchantapi.accounts.ordertrackingsignals.create({
448
+ * const res = await merchantapi.accounts.orderTrackingSignals.create({
449
449
  * // Output only. The ID that uniquely identifies this order tracking signal.
450
450
  * orderTrackingSignalId: 'placeholder-value',
451
451
  * // Required. The account of the business for which the order signal is created. Format: accounts/{account\}
@@ -557,7 +557,7 @@ export namespace merchantapi_ordertracking_v1beta {
557
557
  options: Object.assign(
558
558
  {
559
559
  url: (
560
- rootUrl + '/ordertracking/v1beta/{+parent}/ordertrackingsignals'
560
+ rootUrl + '/ordertracking/v1beta/{+parent}/orderTrackingSignals'
561
561
  ).replace(/([^:]\/)\/+/g, '$1'),
562
562
  method: 'POST',
563
563
  apiVersion: '',
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@googleapis/merchantapi",
3
- "version": "10.1.0",
3
+ "version": "11.0.0",
4
4
  "description": "merchantapi",
5
5
  "main": "build/index.js",
6
6
  "types": "build/index.d.ts",
@@ -245,7 +245,7 @@ export namespace merchantapi_products_v1beta {
245
245
  */
246
246
  energyEfficiencyClass?: string | null;
247
247
  /**
248
- * The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center). For more information, see [Excluded destination](https://support.google.com/merchants/answer/6324486). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
248
+ * Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections. The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center). For more information, see [Excluded destination](https://support.google.com/merchants/answer/6324486). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
249
249
  */
250
250
  excludedDestinations?: string[] | null;
251
251
  /**
@@ -285,7 +285,7 @@ export namespace merchantapi_products_v1beta {
285
285
  */
286
286
  imageLink?: string | null;
287
287
  /**
288
- * The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in `excludedDestinations`. For more information, see [Included destination](https://support.google.com/merchants/answer/7501026). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
288
+ * Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections. The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in `excludedDestinations`. For more information, see [Included destination](https://support.google.com/merchants/answer/7501026). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
289
289
  */
290
290
  includedDestinations?: string[] | null;
291
291
  /**
@@ -823,7 +823,7 @@ export namespace merchantapi_products_v1beta {
823
823
  */
824
824
  feedLabel?: string | null;
825
825
  /**
826
- * The name of the product. Format: `accounts/{account\}/products/{product\}` where the last section `product` consists of 4 parts: `channel~content_language~feed_label~offer_id` example for product name is `accounts/123/products/online~en~US~sku123`
826
+ * The name of the product. Format: `accounts/{account\}/products/{product\}` where the last section `product` consists of: `content_language~feed_label~offer_id` example for product name is `accounts/123/products/en~US~sku123`. A legacy local product name would be `accounts/123/products/local~en~US~sku123`. Note: For calls to the v1beta version, the `product` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/products/online~en~US~sku123`.
827
827
  */
828
828
  name?: string | null;
829
829
  /**
@@ -915,7 +915,7 @@ export namespace merchantapi_products_v1beta {
915
915
  */
916
916
  feedLabel?: string | null;
917
917
  /**
918
- * Identifier. The name of the product input. Format: `accounts/{account\}/productInputs/{productinput\}` where the last section `productinput` consists of 4 parts: `channel~content_language~feed_label~offer_id` example for product input name is `accounts/123/productInputs/online~en~US~sku123`
918
+ * Identifier. The name of the product input. Format: `accounts/{account\}/productInputs/{productinput\}` where the last section `productinput` consists of: `content_language~feed_label~offer_id` example for product input name is `accounts/123/productInputs/en~US~sku123`. A legacy local product input name would be `accounts/123/productInputs/local~en~US~sku123`. Note: For calls to the v1beta version, the `productInput` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/productInputs/online~en~US~sku123`.
919
919
  */
920
920
  name?: string | null;
921
921
  /**
@@ -1251,7 +1251,7 @@ export namespace merchantapi_products_v1beta {
1251
1251
  * const res = await merchantapi.accounts.productInputs.delete({
1252
1252
  * // Required. The primary or supplemental data source from which the product input should be deleted. Format: `accounts/{account\}/dataSources/{datasource\}`. For example, `accounts/123456/dataSources/104628`.
1253
1253
  * dataSource: 'placeholder-value',
1254
- * // Required. The name of the product input resource to delete. Format: `accounts/{account\}/productInputs/{product\}` where the last section `product` consists of 4 parts: `channel~content_language~feed_label~offer_id` example for product name is `accounts/123/productInputs/online~en~US~sku123`.
1254
+ * // Required. The name of the product input resource to delete. Format: `accounts/{account\}/productInputs/{product\}` where the last section `product` consists of: `content_language~feed_label~offer_id` example for product name is `accounts/123/productInputs/en~US~sku123`.
1255
1255
  * name: 'accounts/my-account/productInputs/my-productInput',
1256
1256
  * });
1257
1257
  * console.log(res.data);
@@ -1550,7 +1550,7 @@ export namespace merchantapi_products_v1beta {
1550
1550
  * const res = await merchantapi.accounts.productInputs.patch({
1551
1551
  * // Required. The primary or supplemental product data source where `data_source` name identifies the product input to be updated. Only API data sources are supported. Format: `accounts/{account\}/dataSources/{datasource\}`. For example, `accounts/123456/dataSources/104628`.
1552
1552
  * dataSource: 'placeholder-value',
1553
- * // Identifier. The name of the product input. Format: `accounts/{account\}/productInputs/{productinput\}` where the last section `productinput` consists of 4 parts: `channel~content_language~feed_label~offer_id` example for product input name is `accounts/123/productInputs/online~en~US~sku123`
1553
+ * // Identifier. The name of the product input. Format: `accounts/{account\}/productInputs/{productinput\}` where the last section `productinput` consists of: `content_language~feed_label~offer_id` example for product input name is `accounts/123/productInputs/en~US~sku123`. A legacy local product input name would be `accounts/123/productInputs/local~en~US~sku123`. Note: For calls to the v1beta version, the `productInput` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/productInputs/online~en~US~sku123`.
1554
1554
  * name: 'accounts/my-account/productInputs/my-productInput',
1555
1555
  * // Optional. The list of product attributes to be updated. If the update mask is omitted, then it is treated as implied field mask equivalent to all fields that are populated (have a non-empty value). Attributes specified in the update mask without a value specified in the body will be deleted from the product. Update mask can only be specified for top level fields in attributes and custom attributes. To specify the update mask for custom attributes you need to add the `custom_attribute.` prefix. Providing special "*" value for full product replacement is not supported.
1556
1556
  * updateMask: 'placeholder-value',
@@ -1690,7 +1690,7 @@ export namespace merchantapi_products_v1beta {
1690
1690
  */
1691
1691
  dataSource?: string;
1692
1692
  /**
1693
- * Required. The name of the product input resource to delete. Format: `accounts/{account\}/productInputs/{product\}` where the last section `product` consists of 4 parts: `channel~content_language~feed_label~offer_id` example for product name is `accounts/123/productInputs/online~en~US~sku123`.
1693
+ * Required. The name of the product input resource to delete. Format: `accounts/{account\}/productInputs/{product\}` where the last section `product` consists of: `content_language~feed_label~offer_id` example for product name is `accounts/123/productInputs/en~US~sku123`.
1694
1694
  */
1695
1695
  name?: string;
1696
1696
  }
@@ -1717,7 +1717,7 @@ export namespace merchantapi_products_v1beta {
1717
1717
  */
1718
1718
  dataSource?: string;
1719
1719
  /**
1720
- * Identifier. The name of the product input. Format: `accounts/{account\}/productInputs/{productinput\}` where the last section `productinput` consists of 4 parts: `channel~content_language~feed_label~offer_id` example for product input name is `accounts/123/productInputs/online~en~US~sku123`
1720
+ * Identifier. The name of the product input. Format: `accounts/{account\}/productInputs/{productinput\}` where the last section `productinput` consists of: `content_language~feed_label~offer_id` example for product input name is `accounts/123/productInputs/en~US~sku123`. A legacy local product input name would be `accounts/123/productInputs/local~en~US~sku123`. Note: For calls to the v1beta version, the `productInput` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/productInputs/online~en~US~sku123`.
1721
1721
  */
1722
1722
  name?: string;
1723
1723
  /**
@@ -1768,7 +1768,7 @@ export namespace merchantapi_products_v1beta {
1768
1768
  *
1769
1769
  * // Do the magic
1770
1770
  * const res = await merchantapi.accounts.products.get({
1771
- * // Required. The name of the product to retrieve. Format: `accounts/{account\}/products/{product\}` where the last section `product` consists of 4 parts: `channel~content_language~feed_label~offer_id` example for product name is `accounts/123/products/online~en~US~sku123`
1771
+ * // Required. The name of the product to retrieve. Format: `accounts/{account\}/products/{product\}` where the last section `product` consists of: `content_language~feed_label~offer_id` example for product name is `accounts/123/products/en~US~sku123`. A legacy local product name would be `accounts/123/products/local~en~US~sku123`. Note: For calls to the v1beta version, the `product` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/products/online~en~US~sku123`.
1772
1772
  * name: 'accounts/my-account/products/my-product',
1773
1773
  * });
1774
1774
  * console.log(res.data);
@@ -2032,7 +2032,7 @@ export namespace merchantapi_products_v1beta {
2032
2032
  export interface Params$Resource$Accounts$Products$Get
2033
2033
  extends StandardParameters {
2034
2034
  /**
2035
- * Required. The name of the product to retrieve. Format: `accounts/{account\}/products/{product\}` where the last section `product` consists of 4 parts: `channel~content_language~feed_label~offer_id` example for product name is `accounts/123/products/online~en~US~sku123`
2035
+ * Required. The name of the product to retrieve. Format: `accounts/{account\}/products/{product\}` where the last section `product` consists of: `content_language~feed_label~offer_id` example for product name is `accounts/123/products/en~US~sku123`. A legacy local product name would be `accounts/123/products/local~en~US~sku123`. Note: For calls to the v1beta version, the `product` section consists of: `channel~content_language~feed_label~offer_id`, for example: `accounts/123/products/online~en~US~sku123`.
2036
2036
  */
2037
2037
  name?: string;
2038
2038
  }
@@ -218,7 +218,7 @@ export namespace merchantapi_promotions_v1beta {
218
218
  */
219
219
  productTypeInclusion?: string[] | null;
220
220
  /**
221
- * Required. The list of destinations where the promotion applies to. If you don't specify a destination by including a supported value in your data source, your promotion will display in Shopping ads and free listings by default. You may have previously submitted the following values as destinations for your products: Shopping Actions, Surfaces across Google, Local surfaces across Google. To represent these values use `FREE_LISTINGS`, `FREE_LOCAL_LISTINGS`, `LOCAL_INVENTORY_ADS`. For more details see [Promotion destination](https://support.google.com/merchants/answer/13837465?sjid=5155774230887277618-NC)
221
+ * Required. The list of destinations (also known as [Marketing methods](https://support.google.com/merchants/answer/15130232)) where the promotion applies to. If you don't specify a destination by including a supported value in your data source, your promotion will display in Shopping ads and free listings by default. You may have previously submitted the following values as destinations for your products: Shopping Actions, Surfaces across Google, Local surfaces across Google. To represent these values use `FREE_LISTINGS`, `FREE_LOCAL_LISTINGS`, `LOCAL_INVENTORY_ADS`. For more details see [Promotion destination](https://support.google.com/merchants/answer/13837465?sjid=5155774230887277618-NC)
222
222
  */
223
223
  promotionDestinations?: string[] | null;
224
224
  /**