@googleapis/merchantapi 1.1.0 → 4.1.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.
Files changed (43) hide show
  1. package/CHANGELOG.md +45 -0
  2. package/accounts_v1beta.ts +675 -87
  3. package/build/accounts_v1beta.d.ts +344 -85
  4. package/build/accounts_v1beta.js +138 -1
  5. package/build/accounts_v1beta.js.map +1 -1
  6. package/build/conversions_v1beta.d.ts +15 -10
  7. package/build/conversions_v1beta.js.map +1 -1
  8. package/build/datasources_v1beta.d.ts +187 -19
  9. package/build/datasources_v1beta.js +39 -0
  10. package/build/datasources_v1beta.js.map +1 -1
  11. package/build/index.d.ts +5 -0
  12. package/build/index.js +4 -1
  13. package/build/index.js.map +1 -1
  14. package/build/inventories_v1beta.d.ts +13 -5
  15. package/build/inventories_v1beta.js.map +1 -1
  16. package/build/lfp_v1beta.d.ts +13 -5
  17. package/build/lfp_v1beta.js.map +1 -1
  18. package/build/notifications_v1beta.d.ts +14 -6
  19. package/build/notifications_v1beta.js.map +1 -1
  20. package/build/products_v1beta.d.ts +81 -16
  21. package/build/products_v1beta.js +32 -0
  22. package/build/products_v1beta.js.map +1 -1
  23. package/build/promotions_v1beta.d.ts +14 -6
  24. package/build/promotions_v1beta.js.map +1 -1
  25. package/build/quota_v1beta.d.ts +14 -6
  26. package/build/quota_v1beta.js.map +1 -1
  27. package/build/reports_v1beta.d.ts +13 -5
  28. package/build/reports_v1beta.js.map +1 -1
  29. package/build/reviews_v1beta.d.ts +786 -0
  30. package/build/reviews_v1beta.js +322 -0
  31. package/build/reviews_v1beta.js.map +1 -0
  32. package/conversions_v1beta.ts +15 -10
  33. package/datasources_v1beta.ts +267 -19
  34. package/index.ts +13 -1
  35. package/inventories_v1beta.ts +13 -5
  36. package/lfp_v1beta.ts +13 -5
  37. package/notifications_v1beta.ts +14 -6
  38. package/package.json +1 -1
  39. package/products_v1beta.ts +157 -16
  40. package/promotions_v1beta.ts +14 -6
  41. package/quota_v1beta.ts +14 -6
  42. package/reports_v1beta.ts +13 -5
  43. package/reviews_v1beta.ts +1465 -0
@@ -90,20 +90,7 @@ export declare namespace merchantapi_accounts_v1beta {
90
90
  validUntil?: Schema$Date;
91
91
  }
92
92
  /**
93
- * Reference to a Terms of Service resource.
94
- */
95
- export interface Schema$AcceptTermsOfService {
96
- /**
97
- * Required. The resource name of the terms of service version.
98
- */
99
- name?: string | null;
100
- /**
101
- * Required. Region code as defined by [CLDR](https://cldr.unicode.org/). This is either a country when the ToS applies specifically to that country or `001` when it applies globally.
102
- */
103
- regionCode?: string | null;
104
- }
105
- /**
106
- * An account.
93
+ * The `Account` message represents a merchant's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers. Accounts can operate as standalone entities or be part of a multi-client account (MCA) structure. In an MCA setup the parent account manages multiple sub-accounts. Establishing an account involves configuring attributes like the account name, time zone, and language preferences. The `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on.
107
94
  */
108
95
  export interface Schema$Account {
109
96
  /**
@@ -115,7 +102,7 @@ export declare namespace merchantapi_accounts_v1beta {
115
102
  */
116
103
  accountName?: string | null;
117
104
  /**
118
- * Whether this account contains adult content.
105
+ * Optional. Whether this account contains adult content.
119
106
  */
120
107
  adultContent?: boolean | null;
121
108
  /**
@@ -135,6 +122,11 @@ export declare namespace merchantapi_accounts_v1beta {
135
122
  */
136
123
  timeZone?: Schema$TimeZone;
137
124
  }
125
+ /**
126
+ * `AccountAggregation` payload.
127
+ */
128
+ export interface Schema$AccountAggregation {
129
+ }
138
130
  /**
139
131
  * An [`AccountIssue`](https://support.google.com/merchants/answer/12153802?sjid=17798438912526418908-EU#account).
140
132
  */
@@ -169,11 +161,11 @@ export declare namespace merchantapi_accounts_v1beta {
169
161
  */
170
162
  export interface Schema$AddAccountService {
171
163
  /**
172
- * The provider is an aggregator for the account.
164
+ * The provider is an [aggregator](https://support.google.com/merchants/answer/188487) for the account. Payload for service type Account Aggregation.
173
165
  */
174
- accountAggregation?: Schema$Empty;
166
+ accountAggregation?: Schema$AccountAggregation;
175
167
  /**
176
- * Optional. The provider of the service. Format: `accounts/{account\}`
168
+ * Required. The provider of the service. Either the reference to an account such as `providers/123` or a well-known service provider (one of `providers/GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).
177
169
  */
178
170
  provider?: string | null;
179
171
  }
@@ -202,6 +194,104 @@ export declare namespace merchantapi_accounts_v1beta {
202
194
  */
203
195
  streetAddress?: string | null;
204
196
  }
197
+ /**
198
+ * Instruction for adding a user to the account during creation.
199
+ */
200
+ export interface Schema$AddUser {
201
+ /**
202
+ * Optional. Details about the user to be added. At the moment, only access rights may be specified.
203
+ */
204
+ user?: Schema$User;
205
+ /**
206
+ * Required. The email address of the user (for example, `john.doe@gmail.com`).
207
+ */
208
+ userId?: string | null;
209
+ }
210
+ /**
211
+ * Collection of information related to the [autofeed](https://support.google.com/merchants/answer/7538732) settings.
212
+ */
213
+ export interface Schema$AutofeedSettings {
214
+ /**
215
+ * Output only. Determines whether merchant is eligible for being enrolled into an autofeed.
216
+ */
217
+ eligible?: boolean | null;
218
+ /**
219
+ * Required. Enables or disables product crawling through the autofeed for the given account. Autofeed accounts must meet [certain conditions](https://support.google.com/merchants/answer/7538732#Configure_automated_feeds_Standard_Experience), which can be checked through the `eligible` field. The account must **not** be a marketplace. When the autofeed is enabled for the first time, the products usually appear instantly. When re-enabling, it might take up to 24 hours for products to appear.
220
+ */
221
+ enableProducts?: boolean | null;
222
+ /**
223
+ * Identifier. The resource name of the autofeed settings. Format: `accounts/{account\}/autofeedSettings`.
224
+ */
225
+ name?: string | null;
226
+ }
227
+ /**
228
+ * This improvement will attempt to automatically correct submitted images if they don't meet the [image requirements](https://support.google.com/merchants/answer/6324350), for example, removing overlays. If successful, the image will be replaced and approved. This improvement is only applied to images of disapproved offers. For more information see: [Automatic image improvements](https://support.google.com/merchants/answer/9242973)
229
+ */
230
+ export interface Schema$AutomaticImageImprovements {
231
+ /**
232
+ * Optional. Determines how the images should be automatically updated. If this field is not present and provided in the update mask, then the settings will be deleted. If there are no settings for subaccount, they are inherited from aggregator.
233
+ */
234
+ accountImageImprovementsSettings?: Schema$ImageImprovementsAccountLevelSettings;
235
+ /**
236
+ * Output only. The effective value of allow_automatic_image_improvements. If account_image_improvements_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. Read-only.
237
+ */
238
+ effectiveAllowAutomaticImageImprovements?: boolean | null;
239
+ }
240
+ /**
241
+ * Collection of information related to the [automatic improvements](https://developers.google.com/shopping-content/guides/automatic-improvements) of an account.
242
+ */
243
+ export interface Schema$AutomaticImprovements {
244
+ /**
245
+ * This improvement will attempt to automatically correct submitted images if they don't meet the [image requirements](https://support.google.com/merchants/answer/6324350), for example, removing overlays. If successful, the image will be replaced and approved. This improvement is only applied to images of disapproved offers. For more information see: [Automatic image improvements](https://support.google.com/merchants/answer/9242973) This field is only updated (cleared) if provided in the update mask.
246
+ */
247
+ imageImprovements?: Schema$AutomaticImageImprovements;
248
+ /**
249
+ * Turning on [item updates](https://support.google.com/merchants/answer/3246284) allows Google to automatically update items for you. When item updates are on, Google uses the structured data markup on the website and advanced data extractors to update the price and availability of the items. When the item updates are off, items with mismatched data aren't shown. This field is only updated (cleared) if provided in the update mask.
250
+ */
251
+ itemUpdates?: Schema$AutomaticItemUpdates;
252
+ /**
253
+ * Identifier. The resource name of the automatic improvements. Format: `accounts/{account\}/automaticImprovements`.
254
+ */
255
+ name?: string | null;
256
+ /**
257
+ * Not available for MCAs [accounts](https://support.google.com/merchants/answer/188487). By turning on [automatic shipping improvements](https://support.google.com/merchants/answer/10027038), you are allowing Google to improve the accuracy of your delivery times shown to shoppers using Google. More accurate delivery times, especially when faster, typically lead to better conversion rates. Google will improve your estimated delivery times based on various factors: * Delivery address of an order * Current handling time and shipping time settings * Estimated weekdays or business days * Parcel tracking data This field is only updated (cleared) if provided in the update mask.
258
+ */
259
+ shippingImprovements?: Schema$AutomaticShippingImprovements;
260
+ }
261
+ /**
262
+ * Turning on [item updates](https://support.google.com/merchants/answer/3246284) allows Google to automatically update items for you. When item updates are on, Google uses the structured data markup on the website and advanced data extractors to update the price and availability of the items. When the item updates are off, items with mismatched data aren't shown.
263
+ */
264
+ export interface Schema$AutomaticItemUpdates {
265
+ /**
266
+ * Optional. Determines which attributes of the items should be automatically updated. If this field is not present and provided in the update mask, then the settings will be deleted. If there are no settings for subaccount, they are inherited from aggregator.
267
+ */
268
+ accountItemUpdatesSettings?: Schema$ItemUpdatesAccountLevelSettings;
269
+ /**
270
+ * Output only. The effective value of allow_availability_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.
271
+ */
272
+ effectiveAllowAvailabilityUpdates?: boolean | null;
273
+ /**
274
+ * Output only. The effective value of allow_condition_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.
275
+ */
276
+ effectiveAllowConditionUpdates?: boolean | null;
277
+ /**
278
+ * Output only. The effective value of allow_price_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.
279
+ */
280
+ effectiveAllowPriceUpdates?: boolean | null;
281
+ /**
282
+ * Output only. The effective value of allow_strict_availability_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. The default value is true if no settings are present. Read-only.
283
+ */
284
+ effectiveAllowStrictAvailabilityUpdates?: boolean | null;
285
+ }
286
+ /**
287
+ * Not available for MCAs [accounts](https://support.google.com/merchants/answer/188487). By turning on [automatic shipping improvements](https://support.google.com/merchants/answer/10027038), you are allowing Google to improve the accuracy of your delivery times shown to shoppers using Google. More accurate delivery times, especially when faster, typically lead to better conversion rates. Google will improve your estimated delivery times based on various factors: * Delivery address of an order * Current handling time and shipping time settings * Estimated weekdays or business days * Parcel tracking data
288
+ */
289
+ export interface Schema$AutomaticShippingImprovements {
290
+ /**
291
+ * Enables automatic shipping improvements.
292
+ */
293
+ allowShippingImprovements?: boolean | null;
294
+ }
205
295
  /**
206
296
  * Business days of the warehouse.
207
297
  */
@@ -228,7 +318,7 @@ export declare namespace merchantapi_accounts_v1beta {
228
318
  */
229
319
  name?: string | null;
230
320
  /**
231
- * Optional. Whether the identity attributes may be used for promotions.
321
+ * Required. Whether the identity attributes may be used for promotions.
232
322
  */
233
323
  promotionsConsent?: string | null;
234
324
  /**
@@ -245,11 +335,11 @@ export declare namespace merchantapi_accounts_v1beta {
245
335
  womenOwned?: Schema$IdentityAttribute;
246
336
  }
247
337
  /**
248
- * Collection of information related to a business.
338
+ * The `BusinessInfo` message contains essential information about a merchant's business. This message captures key business details such as physical address, customer service contacts, and region-specific identifiers.
249
339
  */
250
340
  export interface Schema$BusinessInfo {
251
341
  /**
252
- * Optional. The address of the business.
342
+ * Optional. The address of the business. Only `region_code`, `address_lines`, `postal_code`, `administrative_area` and `locality` fields are supported. All other fields are ignored.
253
343
  */
254
344
  address?: Schema$PostalAddress;
255
345
  /**
@@ -274,7 +364,7 @@ export declare namespace merchantapi_accounts_v1beta {
274
364
  phoneVerificationState?: string | null;
275
365
  }
276
366
  /**
277
- * A list of carrier rates that can be referred to by `main_table` or `single_value`.
367
+ * A list of carrier rates that can be referred to by `main_table` or `single_value`. Supported carrier services are defined in https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.
278
368
  */
279
369
  export interface Schema$CarrierRate {
280
370
  /**
@@ -306,26 +396,30 @@ export declare namespace merchantapi_accounts_v1beta {
306
396
  * Request message for the `ClaimHomepage` method.
307
397
  */
308
398
  export interface Schema$ClaimHomepageRequest {
399
+ /**
400
+ * Optional. When set to `true`, this option removes any existing claim on the requested website and replaces it with a claim from the account that makes the request.
401
+ */
402
+ overwrite?: boolean | null;
309
403
  }
310
404
  /**
311
405
  * Request message for the `CreateAndConfigureAccount` method.
312
406
  */
313
407
  export interface Schema$CreateAndConfigureAccountRequest {
314
- /**
315
- * Optional. The Terms of Service (ToS) to be accepted immediately upon account creation.
316
- */
317
- acceptTermsOfService?: Schema$AcceptTermsOfService;
318
408
  /**
319
409
  * Required. The account to be created.
320
410
  */
321
411
  account?: Schema$Account;
322
412
  /**
323
- * Required. An account service between the account to be created and the provider account is initialized as part of the creation. At least one such service needs to be provided. Currently only `account_aggregation` is supported which means the newly created account will be a subaccount of the provider defined in the `account_aggregation` service.
413
+ * Required. An account service between the account to be created and the provider account is initialized as part of the creation. At least one such service needs to be provided. Currently exactly one of these needs to be `account_aggregation`, which means you can only create sub accounts, not standalone account through this method. Additional `account_management` or `product_management` services may be provided.
324
414
  */
325
415
  service?: Schema$AddAccountService[];
326
416
  /**
327
417
  * Optional. Users to be added to the account.
328
418
  */
419
+ user?: Schema$AddUser[];
420
+ /**
421
+ * Optional. Users to be added to the account. This field is deprecated and will not exist after the API evolves out of beta. Use the `user` field instead.
422
+ */
329
423
  users?: Schema$CreateUserRequest[];
330
424
  }
331
425
  /**
@@ -337,7 +431,7 @@ export declare namespace merchantapi_accounts_v1beta {
337
431
  */
338
432
  parent?: string | null;
339
433
  /**
340
- * Required. The user to create.
434
+ * Optional. The user to create.
341
435
  */
342
436
  user?: Schema$User;
343
437
  /**
@@ -426,7 +520,7 @@ export declare namespace merchantapi_accounts_v1beta {
426
520
  */
427
521
  handlingBusinessDayConfig?: Schema$BusinessDayConfig;
428
522
  /**
429
- * Maximum number of business days spent before an order is shipped. 0 means same day shipped, 1 means next day shipped. Must be greater than or equal to `min_handling_days`.
523
+ * Maximum number of business days spent before an order is shipped. 0 means same day shipped, 1 means next day shipped. Must be greater than or equal to `min_handling_days`. 'min_handling_days' and 'max_handling_days' should be either set or not set at the same time.
430
524
  */
431
525
  maxHandlingDays?: number | null;
432
526
  /**
@@ -434,7 +528,7 @@ export declare namespace merchantapi_accounts_v1beta {
434
528
  */
435
529
  maxTransitDays?: number | null;
436
530
  /**
437
- * Minimum number of business days spent before an order is shipped. 0 means same day shipped, 1 means next day shipped.
531
+ * Minimum number of business days spent before an order is shipped. 0 means same day shipped, 1 means next day shipped. 'min_handling_days' and 'max_handling_days' should be either set or not set at the same time.
438
532
  */
439
533
  minHandlingDays?: number | null;
440
534
  /**
@@ -530,7 +624,7 @@ export declare namespace merchantapi_accounts_v1beta {
530
624
  weights?: Schema$Weight[];
531
625
  }
532
626
  /**
533
- * A store's homepage.
627
+ * The `Homepage` message represents a merchant's store homepage within the system. A merchant's homepage is the primary domain where customers interact with their store. The homepage can be claimed and verified as a proof of ownership and allows the merchant to unlock features that require a verified website. For more information, see [Understanding online store URL verification](//support.google.com/merchants/answer/176793).
534
628
  */
535
629
  export interface Schema$Homepage {
536
630
  /**
@@ -555,6 +649,15 @@ export declare namespace merchantapi_accounts_v1beta {
555
649
  */
556
650
  identityDeclaration?: string | null;
557
651
  }
652
+ /**
653
+ * Settings for the Automatic Image Improvements.
654
+ */
655
+ export interface Schema$ImageImprovementsAccountLevelSettings {
656
+ /**
657
+ * Enables automatic image improvements.
658
+ */
659
+ allowAutomaticImageImprovements?: boolean | null;
660
+ }
558
661
  /**
559
662
  * The impact of the issue on a region.
560
663
  */
@@ -581,6 +684,27 @@ export declare namespace merchantapi_accounts_v1beta {
581
684
  */
582
685
  reportingContext?: string | null;
583
686
  }
687
+ /**
688
+ * Settings for the Automatic Item Updates.
689
+ */
690
+ export interface Schema$ItemUpdatesAccountLevelSettings {
691
+ /**
692
+ * If availability updates are enabled, any previous availability values get overwritten if Google finds an out-of-stock annotation on the offer's page. If additionally `allow_strict_availability_updates` field is set to true, values get overwritten if Google finds an in-stock annotation on the offer’s page.
693
+ */
694
+ allowAvailabilityUpdates?: boolean | null;
695
+ /**
696
+ * If condition updates are enabled, Google always updates item condition with the condition detected from the details of your product.
697
+ */
698
+ allowConditionUpdates?: boolean | null;
699
+ /**
700
+ * If price updates are enabled, Google always updates the active price with the crawled information.
701
+ */
702
+ allowPriceUpdates?: boolean | null;
703
+ /**
704
+ * If `allow_availability_updates` is enabled, items are automatically updated in all your Shopping target countries. By default, availability updates will only be applied to items that are 'out of stock' on your website but 'in stock' on Shopping. Set this to true to also update items that are 'in stock' on your website, but 'out of stock' on Google Shopping. In order for this field to have an effect, you must also set `allow_availability_updates`.
705
+ */
706
+ allowStrictAvailabilityUpdates?: boolean | null;
707
+ }
584
708
  /**
585
709
  * Response message for the `ListAccountIssues` method.
586
710
  */
@@ -738,15 +862,15 @@ export declare namespace merchantapi_accounts_v1beta {
738
862
  */
739
863
  acceptExchange?: boolean | null;
740
864
  /**
741
- * The countries of sale where the return policy applies. The values must be a valid 2 letter ISO 3166 code.
865
+ * Required. Immutable. The countries of sale where the return policy applies. The values must be a valid 2 letter ISO 3166 code.
742
866
  */
743
867
  countries?: string[] | null;
744
868
  /**
745
- * The item conditions accepted for returns must not be empty unless the type of return policy is 'noReturns'.
869
+ * Optional. The item conditions accepted for returns must not be empty unless the type of return policy is 'noReturns'.
746
870
  */
747
871
  itemConditions?: string[] | null;
748
872
  /**
749
- * This field represents the unique user-defined label of the return policy. It is important to note that the same label cannot be used in different return policies for the same country. Unless a product specifies a specific label attribute, policies will be automatically labeled as 'default'. To assign a custom return policy to certain product groups, follow the instructions provided in the [Return policy label] (https://support.google.com/merchants/answer/9445425). The label can contain up to 50 characters.
873
+ * Required. Immutable. This field represents the unique user-defined label of the return policy. It is important to note that the same label cannot be used in different return policies for the same country. Unless a product specifies a specific label attribute, policies will be automatically labeled as 'default'. To assign a custom return policy to certain product groups, follow the instructions provided in the [Return policy label] (https://support.google.com/merchants/answer/9445425). The label can contain up to 50 characters.
750
874
  */
751
875
  label?: string | null;
752
876
  /**
@@ -754,7 +878,7 @@ export declare namespace merchantapi_accounts_v1beta {
754
878
  */
755
879
  name?: string | null;
756
880
  /**
757
- * The return policy.
881
+ * Optional. The return policy.
758
882
  */
759
883
  policy?: Schema$Policy;
760
884
  /**
@@ -762,11 +886,11 @@ export declare namespace merchantapi_accounts_v1beta {
762
886
  */
763
887
  processRefundDays?: number | null;
764
888
  /**
765
- * The restocking fee that applies to all return reason categories. This would be treated as a free restocking fee if the value is not set.
889
+ * Optional. The restocking fee that applies to all return reason categories. This would be treated as a free restocking fee if the value is not set.
766
890
  */
767
891
  restockingFee?: Schema$RestockingFee;
768
892
  /**
769
- * The return methods of how customers can return an item. This value is required to not be empty unless the type of return policy is noReturns.
893
+ * Optional. The return methods of how customers can return an item. This value is required to not be empty unless the type of return policy is noReturns.
770
894
  */
771
895
  returnMethods?: string[] | null;
772
896
  /**
@@ -774,20 +898,24 @@ export declare namespace merchantapi_accounts_v1beta {
774
898
  */
775
899
  returnPolicyId?: string | null;
776
900
  /**
777
- * The return policy uri. This can used by Google to do a sanity check for the policy. It must be a valid URL.
901
+ * Required. The return policy uri. This can used by Google to do a sanity check for the policy. It must be a valid URL.
778
902
  */
779
903
  returnPolicyUri?: string | null;
780
904
  /**
781
- * The return shipping fee. Should be set only when customer need to download and print the return label.
905
+ * Optional. The return shipping fee. Should be set only when customer need to download and print the return label.
782
906
  */
783
907
  returnShippingFee?: Schema$ReturnShippingFee;
908
+ /**
909
+ * Optional. Overrides to the general policy for orders placed during a specific set of time intervals.
910
+ */
911
+ seasonalOverrides?: Schema$SeasonalOverride[];
784
912
  }
785
913
  /**
786
914
  * An object representing a phone number, suitable as an API wire format. This representation: - should not be used for locale-specific formatting of a phone number, such as "+1 (650) 253-0000 ext. 123" - is not designed for efficient storage - may not be suitable for dialing - specialized libraries (see references) should be used to parse the number for that purpose To do something meaningful with this number, such as format it for various use-cases, convert it to an `i18n.phonenumbers.PhoneNumber` object first. For instance, in Java this would be: com.google.type.PhoneNumber wireProto = com.google.type.PhoneNumber.newBuilder().build(); com.google.i18n.phonenumbers.Phonenumber.PhoneNumber phoneNumber = PhoneNumberUtil.getInstance().parse(wireProto.getE164Number(), "ZZ"); if (!wireProto.getExtension().isEmpty()) { phoneNumber.setExtension(wireProto.getExtension()); \} Reference(s): - https://github.com/google/libphonenumber
787
915
  */
788
916
  export interface Schema$PhoneNumber {
789
917
  /**
790
- * The phone number, represented as a leading plus sign ('+'), followed by a phone number that uses a relaxed ITU E.164 format consisting of the country calling code (1 to 3 digits) and the subscriber number, with no additional spaces or formatting, e.g.: - correct: "+15552220123" - incorrect: "+1 (555) 222-01234 x123". The ITU E.164 format limits the latter to 12 digits, but in practice not all countries respect that, so we relax that restriction here. National-only numbers are not allowed. References: - https://www.itu.int/rec/T-REC-E.164-201011-I - https://en.wikipedia.org/wiki/E.164. - https://en.wikipedia.org/wiki/List_of_country_calling_codes
918
+ * The phone number, represented as a leading plus sign ('+'), followed by a phone number that uses a relaxed ITU E.164 format consisting of the country calling code (1 to 3 digits) and the subscriber number, with no additional spaces or formatting. For example: - correct: "+15552220123" - incorrect: "+1 (555) 222-01234 x123". The ITU E.164 format limits the latter to 12 digits, but in practice not all countries respect that, so we relax that restriction here. National-only numbers are not allowed. References: - https://www.itu.int/rec/T-REC-E.164-201011-I - https://en.wikipedia.org/wiki/E.164. - https://en.wikipedia.org/wiki/List_of_country_calling_codes
791
919
  */
792
920
  e164Number?: string | null;
793
921
  /**
@@ -813,15 +941,15 @@ export declare namespace merchantapi_accounts_v1beta {
813
941
  type?: string | null;
814
942
  }
815
943
  /**
816
- * Represents a postal address, e.g. for postal delivery or payments addresses. Given a postal address, a postal service can deliver items to a premise, P.O. Box or similar. It is not intended to model geographical locations (roads, towns, mountains). In typical usage an address would be created via user input or from importing existing data, depending on the type of process. Advice on address input / editing: - Use an internationalization-ready address widget such as https://github.com/google/libaddressinput) - Users should not be presented with UI elements for input or editing of fields outside countries where that field is used. For more guidance on how to use this schema, please see: https://support.google.com/business/answer/6397478
944
+ * Represents a postal address. For example for postal delivery or payments addresses. Given a postal address, a postal service can deliver items to a premise, P.O. Box or similar. It is not intended to model geographical locations (roads, towns, mountains). In typical usage an address would be created by user input or from importing existing data, depending on the type of process. Advice on address input / editing: - Use an internationalization-ready address widget such as https://github.com/google/libaddressinput) - Users should not be presented with UI elements for input or editing of fields outside countries where that field is used. For more guidance on how to use this schema, see: https://support.google.com/business/answer/6397478
817
945
  */
818
946
  export interface Schema$PostalAddress {
819
947
  /**
820
- * Unstructured address lines describing the lower levels of an address. Because values in address_lines do not have type information and may sometimes contain multiple values in a single field (e.g. "Austin, TX"), it is important that the line order is clear. The order of address lines should be "envelope order" for the country/region of the address. In places where this can vary (e.g. Japan), address_language is used to make it explicit (e.g. "ja" for large-to-small ordering and "ja-Latn" or "en" for small-to-large). This way, the most specific line of an address can be selected based on the language. The minimum permitted structural representation of an address consists of a region_code with all remaining information placed in the address_lines. It would be possible to format such an address very approximately without geocoding, but no semantic reasoning could be made about any of the address components until it was at least partially resolved. Creating an address only containing a region_code and address_lines, and then geocoding is the recommended way to handle completely unstructured addresses (as opposed to guessing which parts of the address should be localities or administrative areas).
948
+ * Unstructured address lines describing the lower levels of an address. Because values in address_lines do not have type information and may sometimes contain multiple values in a single field (For example "Austin, TX"), it is important that the line order is clear. The order of address lines should be "envelope order" for the country/region of the address. In places where this can vary (For example Japan), address_language is used to make it explicit (For example "ja" for large-to-small ordering and "ja-Latn" or "en" for small-to-large). This way, the most specific line of an address can be selected based on the language. The minimum permitted structural representation of an address consists of a region_code with all remaining information placed in the address_lines. It would be possible to format such an address very approximately without geocoding, but no semantic reasoning could be made about any of the address components until it was at least partially resolved. Creating an address only containing a region_code and address_lines, and then geocoding is the recommended way to handle completely unstructured addresses (as opposed to guessing which parts of the address should be localities or administrative areas).
821
949
  */
822
950
  addressLines?: string[] | null;
823
951
  /**
824
- * Optional. Highest administrative subdivision which is used for postal addresses of a country or region. For example, this can be a state, a province, an oblast, or a prefecture. Specifically, for Spain this is the province and not the autonomous community (e.g. "Barcelona" and not "Catalonia"). Many countries don't use an administrative area in postal addresses. E.g. in Switzerland this should be left unpopulated.
952
+ * Optional. Highest administrative subdivision which is used for postal addresses of a country or region. For example, this can be a state, a province, an oblast, or a prefecture. Specifically, for Spain this is the province and not the autonomous community (For example "Barcelona" and not "Catalonia"). Many countries don't use an administrative area in postal addresses. For example in Switzerland this should be left unpopulated.
825
953
  */
826
954
  administrativeArea?: string | null;
827
955
  /**
@@ -837,7 +965,7 @@ export declare namespace merchantapi_accounts_v1beta {
837
965
  */
838
966
  organization?: string | null;
839
967
  /**
840
- * Optional. Postal code of the address. Not all countries use or require postal codes to be present, but where they are used, they may trigger additional validation with other parts of the address (e.g. state/zip validation in the U.S.A.).
968
+ * Optional. Postal code of the address. Not all countries use or require postal codes to be present, but where they are used, they may trigger additional validation with other parts of the address (For example state/zip validation in the U.S.A.).
841
969
  */
842
970
  postalCode?: string | null;
843
971
  /**
@@ -853,7 +981,7 @@ export declare namespace merchantapi_accounts_v1beta {
853
981
  */
854
982
  revision?: number | null;
855
983
  /**
856
- * Optional. Additional, country-specific, sorting code. This is not used in most regions. Where it is used, the value is either a string like "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number alone, representing the "sector code" (Jamaica), "delivery area indicator" (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
984
+ * Optional. Additional, country-specific, sorting code. This is not used in most regions. Where it is used, the value is either a string like "CEDEX", optionally followed by a number (For example "CEDEX 7"), or just a number alone, representing the "sector code" (Jamaica), "delivery area indicator" (Malawi) or "post office indicator" (For example Côte d'Ivoire).
857
985
  */
858
986
  sortingCode?: string | null;
859
987
  /**
@@ -905,19 +1033,19 @@ export declare namespace merchantapi_accounts_v1beta {
905
1033
  */
906
1034
  export interface Schema$ProductChange {
907
1035
  /**
908
- * The new value of the changed resource or attribute.
1036
+ * The new value of the changed resource or attribute. If empty, it means that the product was deleted. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)
909
1037
  */
910
1038
  newValue?: string | null;
911
1039
  /**
912
- * The old value of the changed resource or attribute.
1040
+ * The old value of the changed resource or attribute. If empty, it means that the product was created. Will have one of these values : (`approved`, `pending`, `disapproved`, ``)
913
1041
  */
914
1042
  oldValue?: string | null;
915
1043
  /**
916
- * Countries that have the change (if applicable)
1044
+ * Countries that have the change (if applicable). Represented in the ISO 3166 format.
917
1045
  */
918
1046
  regionCode?: string | null;
919
1047
  /**
920
- * Reporting contexts that have the change (if applicable)
1048
+ * Reporting contexts that have the change (if applicable). Currently this field supports only (`SHOPPING_ADS`, `LOCAL_INVENTORY_ADS`, `YOUTUBE_SHOPPING`, `YOUTUBE_CHECKOUT`, `YOUTUBE_AFFILIATE`) from the enum value [ReportingContextEnum](/merchant/api/reference/rest/Shared.Types/ReportingContextEnum)
921
1049
  */
922
1050
  reportingContext?: string | null;
923
1051
  }
@@ -937,12 +1065,20 @@ export declare namespace merchantapi_accounts_v1beta {
937
1065
  * A message to describe the change that happened to the product
938
1066
  */
939
1067
  changes?: Schema$ProductChange[];
1068
+ /**
1069
+ * The time at which the event was generated. If you want to order the notification messages you receive you should rely on this field not on the order of receiving the notifications.
1070
+ */
1071
+ eventTime?: string | null;
1072
+ /**
1073
+ * Optional. The product expiration time. This field will not bet set if the notification is sent for a product deletion event.
1074
+ */
1075
+ expirationTime?: string | null;
940
1076
  /**
941
1077
  * The account that manages the merchant's account. can be the same as merchant id if it is standalone account. Format : `accounts/{service_provider_id\}`
942
1078
  */
943
1079
  managingAccount?: string | null;
944
1080
  /**
945
- * The product name. Format: `{product.name=accounts/{account\}/products/{product\}\}`
1081
+ * The product name. Format: `accounts/{account\}/products/{product\}`
946
1082
  */
947
1083
  resource?: string | null;
948
1084
  /**
@@ -955,7 +1091,7 @@ export declare namespace merchantapi_accounts_v1beta {
955
1091
  resourceType?: string | null;
956
1092
  }
957
1093
  /**
958
- * Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to merchant accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/topic/9240261?ref_topic=7257954,7259405,&sjid=796648681813264022-EU) program, which enables products from a merchant's store to be shown across Google for free.
1094
+ * Defines participation in a given program for the specified account. Programs provide a mechanism for adding functionality to merchant accounts. A typical example of this is the [Free product listings](https://support.google.com/merchants/topic/9240261?ref_topic=7257954,7259405,&sjid=796648681813264022-EU) program, which enables products from a merchant's store to be shown across Google for free. The following list is the available set of program resource IDs accessible through the API: * `free-listings` * `shopping-ads` * `youtube-shopping-checkout`
959
1095
  */
960
1096
  export interface Schema$Program {
961
1097
  /**
@@ -1089,7 +1225,7 @@ export declare namespace merchantapi_accounts_v1beta {
1089
1225
  */
1090
1226
  fixedFee?: Schema$Price;
1091
1227
  /**
1092
- * Type of return shipping fee.
1228
+ * Required. Type of return shipping fee.
1093
1229
  */
1094
1230
  type?: string | null;
1095
1231
  }
@@ -1102,6 +1238,28 @@ export declare namespace merchantapi_accounts_v1beta {
1102
1238
  */
1103
1239
  cells?: Schema$Value[];
1104
1240
  }
1241
+ export interface Schema$SeasonalOverride {
1242
+ /**
1243
+ * Required. seasonal override end date (inclusive).
1244
+ */
1245
+ endDate?: Schema$Date;
1246
+ /**
1247
+ * Required. Display name of this seasonal override in Merchant Center.
1248
+ */
1249
+ label?: string | null;
1250
+ /**
1251
+ * Number of days (from the delivery date) that the product can be returned.
1252
+ */
1253
+ returnDays?: number | null;
1254
+ /**
1255
+ * Fixed end date until which the product can be returned.
1256
+ */
1257
+ returnUntilDate?: Schema$Date;
1258
+ /**
1259
+ * Required. Defines the date range when this seasonal override applies. Both start_date and end_date are inclusive. The dates of the seasonal overrides should not overlap.
1260
+ */
1261
+ startDate?: Schema$Date;
1262
+ }
1105
1263
  /**
1106
1264
  * Shipping service.
1107
1265
  */
@@ -1152,7 +1310,7 @@ export declare namespace merchantapi_accounts_v1beta {
1152
1310
  storeConfig?: Schema$StoreConfig;
1153
1311
  }
1154
1312
  /**
1155
- * The merchant account's [shipping setting]((https://support.google.com/merchants/answer/6069284).
1313
+ * The merchant account's [shipping setting](https://support.google.com/merchants/answer/6069284).
1156
1314
  */
1157
1315
  export interface Schema$ShippingSettings {
1158
1316
  /**
@@ -1173,11 +1331,11 @@ export declare namespace merchantapi_accounts_v1beta {
1173
1331
  warehouses?: Schema$Warehouse[];
1174
1332
  }
1175
1333
  /**
1176
- * An object representing a short code, which is a phone number that is typically much shorter than regular phone numbers and can be used to address messages in MMS and SMS systems, as well as for abbreviated dialing (e.g. "Text 611 to see how many minutes you have remaining on your plan."). Short codes are restricted to a region and are not internationally dialable, which means the same short code can exist in different regions, with different usage and pricing, even if those regions share the same country calling code (e.g. US and CA).
1334
+ * An object representing a short code, which is a phone number that is typically much shorter than regular phone numbers and can be used to address messages in MMS and SMS systems, as well as for abbreviated dialing (For example "Text 611 to see how many minutes you have remaining on your plan."). Short codes are restricted to a region and are not internationally dialable, which means the same short code can exist in different regions, with different usage and pricing, even if those regions share the same country calling code (For example: US and CA).
1177
1335
  */
1178
1336
  export interface Schema$ShortCode {
1179
1337
  /**
1180
- * Required. The short code digits, without a leading plus ('+') or country calling code, e.g. "611".
1338
+ * Required. The short code digits, without a leading plus ('+') or country calling code. For example "611".
1181
1339
  */
1182
1340
  number?: string | null;
1183
1341
  /**
@@ -1241,7 +1399,7 @@ export declare namespace merchantapi_accounts_v1beta {
1241
1399
  rows?: Schema$Row[];
1242
1400
  }
1243
1401
  /**
1244
- * A `TermsOfService`.
1402
+ * The `TermsOfService` message represents a specific version of the terms of service that merchants must accept to access certain features or services (see https://support.google.com/merchants/answer/160173). This message is important for the onboarding process, ensuring that merchants agree to the necessary legal agreements for using the service. Merchants can retrieve the latest terms of service for a given `kind` and `region` through `RetrieveLatestTermsOfService`, and accept them as required through `AcceptTermsOfService`.
1245
1403
  */
1246
1404
  export interface Schema$TermsOfService {
1247
1405
  /**
@@ -1295,11 +1453,11 @@ export declare namespace merchantapi_accounts_v1beta {
1295
1453
  */
1296
1454
  export interface Schema$TimeZone {
1297
1455
  /**
1298
- * IANA Time Zone Database time zone, e.g. "America/New_York".
1456
+ * IANA Time Zone Database time zone. For example "America/New_York".
1299
1457
  */
1300
1458
  id?: string | null;
1301
1459
  /**
1302
- * Optional. IANA Time Zone Database version number, e.g. "2019a".
1460
+ * Optional. IANA Time Zone Database version number. For example "2019a".
1303
1461
  */
1304
1462
  version?: string | null;
1305
1463
  }
@@ -1348,11 +1506,11 @@ export declare namespace merchantapi_accounts_v1beta {
1348
1506
  export interface Schema$UnclaimHomepageRequest {
1349
1507
  }
1350
1508
  /**
1351
- * A [user](https://support.google.com/merchants/answer/12160472).
1509
+ * The `User` message represents a user associated with a Merchant Center account. It is used to manage user permissions and access rights within the account. For more information, see [Frequently asked questions about people and access levels](//support.google.com/merchants/answer/12160472).
1352
1510
  */
1353
1511
  export interface Schema$User {
1354
1512
  /**
1355
- * Optional. The [access rights](https://support.google.com/merchants/answer/12160472?sjid=6789834943175119429-EU#accesstypes) the user has.
1513
+ * Required. The [access rights](https://support.google.com/merchants/answer/12160472?sjid=6789834943175119429-EU#accesstypes) the user has.
1356
1514
  */
1357
1515
  accessRights?: string[] | null;
1358
1516
  /**
@@ -1390,7 +1548,7 @@ export declare namespace merchantapi_accounts_v1beta {
1390
1548
  subtable?: string | null;
1391
1549
  }
1392
1550
  /**
1393
- * A fulfillment warehouse, which stores and handles inventory. Next tag: 7
1551
+ * A fulfillment warehouse, which stores and handles inventory.
1394
1552
  */
1395
1553
  export interface Schema$Warehouse {
1396
1554
  /**
@@ -1419,7 +1577,7 @@ export declare namespace merchantapi_accounts_v1beta {
1419
1577
  */
1420
1578
  export interface Schema$WarehouseBasedDeliveryTime {
1421
1579
  /**
1422
- * Required. Carrier, such as `"UPS"` or `"Fedex"`.
1580
+ * Required. Carrier, such as `"UPS"` or `"Fedex"`. [supported carriers](https://support.google.com/merchants/answer/7050921#zippy=%2Ccarrier-rates-au-de-uk-and-us-only)
1423
1581
  */
1424
1582
  carrier?: string | null;
1425
1583
  /**
@@ -1459,9 +1617,10 @@ export declare namespace merchantapi_accounts_v1beta {
1459
1617
  }
1460
1618
  export class Resource$Accounts {
1461
1619
  context: APIRequestContext;
1620
+ autofeedSettings: Resource$Accounts$Autofeedsettings;
1462
1621
  businessIdentity: Resource$Accounts$Businessidentity;
1463
1622
  businessInfo: Resource$Accounts$Businessinfo;
1464
- emailpreferences: Resource$Accounts$Emailpreferences;
1623
+ emailPreferences: Resource$Accounts$Emailpreferences;
1465
1624
  homepage: Resource$Accounts$Homepage;
1466
1625
  issues: Resource$Accounts$Issues;
1467
1626
  onlineReturnPolicies: Resource$Accounts$Onlinereturnpolicies;
@@ -1486,7 +1645,7 @@ export declare namespace merchantapi_accounts_v1beta {
1486
1645
  createAndConfigure(params: Params$Resource$Accounts$Createandconfigure, callback: BodyResponseCallback<Schema$Account>): void;
1487
1646
  createAndConfigure(callback: BodyResponseCallback<Schema$Account>): void;
1488
1647
  /**
1489
- * Deletes the specified account regardless of its type: standalone, MCA or sub-account. Deleting an MCA leads to the deletion of all of its sub-accounts. Executing this method requires admin access.
1648
+ * Deletes the specified account regardless of its type: standalone, MCA or sub-account. Deleting an MCA leads to the deletion of all of its sub-accounts. Executing this method requires admin access. The deletion succeeds only if the account does not provide services to any other account and has no processed offers. You can use the `force` parameter to override this.
1490
1649
  *
1491
1650
  * @param params - Parameters for request
1492
1651
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1514,7 +1673,21 @@ export declare namespace merchantapi_accounts_v1beta {
1514
1673
  get(params: Params$Resource$Accounts$Get, callback: BodyResponseCallback<Schema$Account>): void;
1515
1674
  get(callback: BodyResponseCallback<Schema$Account>): void;
1516
1675
  /**
1517
- * Lists accounts accessible to the calling user and matching the constraints of the request such as page size or filters. This is not just listing the sub-accounts of an MCA, but all accounts the calling user has access to including other MCAs, linked accounts, standalone accounts and so on.
1676
+ * Retrieves the automatic improvements of an account.
1677
+ *
1678
+ * @param params - Parameters for request
1679
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
1680
+ * @param callback - Optional callback that handles the response.
1681
+ * @returns A promise if used with async/await, or void if used with a callback.
1682
+ */
1683
+ getAutomaticImprovements(params: Params$Resource$Accounts$Getautomaticimprovements, options: StreamMethodOptions): GaxiosPromise<Readable>;
1684
+ getAutomaticImprovements(params?: Params$Resource$Accounts$Getautomaticimprovements, options?: MethodOptions): GaxiosPromise<Schema$AutomaticImprovements>;
1685
+ getAutomaticImprovements(params: Params$Resource$Accounts$Getautomaticimprovements, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
1686
+ getAutomaticImprovements(params: Params$Resource$Accounts$Getautomaticimprovements, options: MethodOptions | BodyResponseCallback<Schema$AutomaticImprovements>, callback: BodyResponseCallback<Schema$AutomaticImprovements>): void;
1687
+ getAutomaticImprovements(params: Params$Resource$Accounts$Getautomaticimprovements, callback: BodyResponseCallback<Schema$AutomaticImprovements>): void;
1688
+ getAutomaticImprovements(callback: BodyResponseCallback<Schema$AutomaticImprovements>): void;
1689
+ /**
1690
+ * Lists accounts accessible to the calling user and matching the constraints of the request such as page size or filters. This is not just listing the sub-accounts of an MCA, but all accounts the calling user has access to including other MCAs, linked accounts, standalone accounts and so on. If no filter is provided, then it returns all the accounts the user has access to. This method is eventually consistent, meaning changes such as creating, updating an account or a change of relationships between accounts may not show up in the results immediately. Instead, these changes propagate over a short period, after which the updated information can match the associated predicates. That means, that searching by account name might not return a recently changed account even though it satisfies the predicate.
1518
1691
  *
1519
1692
  * @param params - Parameters for request
1520
1693
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1555,6 +1728,20 @@ export declare namespace merchantapi_accounts_v1beta {
1555
1728
  patch(params: Params$Resource$Accounts$Patch, options: MethodOptions | BodyResponseCallback<Schema$Account>, callback: BodyResponseCallback<Schema$Account>): void;
1556
1729
  patch(params: Params$Resource$Accounts$Patch, callback: BodyResponseCallback<Schema$Account>): void;
1557
1730
  patch(callback: BodyResponseCallback<Schema$Account>): void;
1731
+ /**
1732
+ * Updates the automatic improvements of an account.
1733
+ *
1734
+ * @param params - Parameters for request
1735
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
1736
+ * @param callback - Optional callback that handles the response.
1737
+ * @returns A promise if used with async/await, or void if used with a callback.
1738
+ */
1739
+ updateAutomaticImprovements(params: Params$Resource$Accounts$Updateautomaticimprovements, options: StreamMethodOptions): GaxiosPromise<Readable>;
1740
+ updateAutomaticImprovements(params?: Params$Resource$Accounts$Updateautomaticimprovements, options?: MethodOptions): GaxiosPromise<Schema$AutomaticImprovements>;
1741
+ updateAutomaticImprovements(params: Params$Resource$Accounts$Updateautomaticimprovements, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
1742
+ updateAutomaticImprovements(params: Params$Resource$Accounts$Updateautomaticimprovements, options: MethodOptions | BodyResponseCallback<Schema$AutomaticImprovements>, callback: BodyResponseCallback<Schema$AutomaticImprovements>): void;
1743
+ updateAutomaticImprovements(params: Params$Resource$Accounts$Updateautomaticimprovements, callback: BodyResponseCallback<Schema$AutomaticImprovements>): void;
1744
+ updateAutomaticImprovements(callback: BodyResponseCallback<Schema$AutomaticImprovements>): void;
1558
1745
  }
1559
1746
  export interface Params$Resource$Accounts$Createandconfigure extends StandardParameters {
1560
1747
  /**
@@ -1563,6 +1750,10 @@ export declare namespace merchantapi_accounts_v1beta {
1563
1750
  requestBody?: Schema$CreateAndConfigureAccountRequest;
1564
1751
  }
1565
1752
  export interface Params$Resource$Accounts$Delete extends StandardParameters {
1753
+ /**
1754
+ * Optional. If set to `true`, the account is deleted even if it provides services to other accounts or has processed offers.
1755
+ */
1756
+ force?: boolean;
1566
1757
  /**
1567
1758
  * Required. The name of the account to delete. Format: `accounts/{account\}`
1568
1759
  */
@@ -1574,9 +1765,15 @@ export declare namespace merchantapi_accounts_v1beta {
1574
1765
  */
1575
1766
  name?: string;
1576
1767
  }
1768
+ export interface Params$Resource$Accounts$Getautomaticimprovements extends StandardParameters {
1769
+ /**
1770
+ * Required. The resource name of the automatic improvements. Format: `accounts/{account\}/automaticImprovements`
1771
+ */
1772
+ name?: string;
1773
+ }
1577
1774
  export interface Params$Resource$Accounts$List extends StandardParameters {
1578
1775
  /**
1579
- * Optional. Returns only accounts that match the [filter](/merchant/api/guides/accounts/filter). For more details, see the [filter syntax reference](/merchant/api/guides/accounts/filter-syntax).
1776
+ * Optional. Returns only accounts that match the [filter](https://developers.google.com/merchant/api/guides/accounts/filter). For more details, see the [filter syntax reference](https://developers.google.com/merchant/api/guides/accounts/filter-syntax).
1580
1777
  */
1581
1778
  filter?: string;
1582
1779
  /**
@@ -1598,7 +1795,7 @@ export declare namespace merchantapi_accounts_v1beta {
1598
1795
  */
1599
1796
  pageToken?: string;
1600
1797
  /**
1601
- * Required. The parent account. Format: `accounts/{account\}`
1798
+ * Required. The aggregation service provider. Format: `providers/{providerId\}`
1602
1799
  */
1603
1800
  provider?: string;
1604
1801
  }
@@ -1608,7 +1805,7 @@ export declare namespace merchantapi_accounts_v1beta {
1608
1805
  */
1609
1806
  name?: string;
1610
1807
  /**
1611
- * Required. List of fields being updated.
1808
+ * Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `account_name` - `adult_content` - `language_code` - `time_zone`
1612
1809
  */
1613
1810
  updateMask?: string;
1614
1811
  /**
@@ -1616,6 +1813,72 @@ export declare namespace merchantapi_accounts_v1beta {
1616
1813
  */
1617
1814
  requestBody?: Schema$Account;
1618
1815
  }
1816
+ export interface Params$Resource$Accounts$Updateautomaticimprovements extends StandardParameters {
1817
+ /**
1818
+ * Identifier. The resource name of the automatic improvements. Format: `accounts/{account\}/automaticImprovements`.
1819
+ */
1820
+ name?: string;
1821
+ /**
1822
+ * Required. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `item_updates` - `item_updates.account_level_settings` - `image_improvements` - `image_improvements.account_level_settings` - `shipping_improvements` - `shipping_improvements.allow_shipping_improvements`
1823
+ */
1824
+ updateMask?: string;
1825
+ /**
1826
+ * Request body metadata
1827
+ */
1828
+ requestBody?: Schema$AutomaticImprovements;
1829
+ }
1830
+ export class Resource$Accounts$Autofeedsettings {
1831
+ context: APIRequestContext;
1832
+ constructor(context: APIRequestContext);
1833
+ /**
1834
+ * Retrieves the autofeed settings of an account.
1835
+ *
1836
+ * @param params - Parameters for request
1837
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
1838
+ * @param callback - Optional callback that handles the response.
1839
+ * @returns A promise if used with async/await, or void if used with a callback.
1840
+ */
1841
+ getAutofeedSettings(params: Params$Resource$Accounts$Autofeedsettings$Getautofeedsettings, options: StreamMethodOptions): GaxiosPromise<Readable>;
1842
+ getAutofeedSettings(params?: Params$Resource$Accounts$Autofeedsettings$Getautofeedsettings, options?: MethodOptions): GaxiosPromise<Schema$AutofeedSettings>;
1843
+ getAutofeedSettings(params: Params$Resource$Accounts$Autofeedsettings$Getautofeedsettings, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
1844
+ getAutofeedSettings(params: Params$Resource$Accounts$Autofeedsettings$Getautofeedsettings, options: MethodOptions | BodyResponseCallback<Schema$AutofeedSettings>, callback: BodyResponseCallback<Schema$AutofeedSettings>): void;
1845
+ getAutofeedSettings(params: Params$Resource$Accounts$Autofeedsettings$Getautofeedsettings, callback: BodyResponseCallback<Schema$AutofeedSettings>): void;
1846
+ getAutofeedSettings(callback: BodyResponseCallback<Schema$AutofeedSettings>): void;
1847
+ /**
1848
+ * Updates the autofeed settings of an account.
1849
+ *
1850
+ * @param params - Parameters for request
1851
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
1852
+ * @param callback - Optional callback that handles the response.
1853
+ * @returns A promise if used with async/await, or void if used with a callback.
1854
+ */
1855
+ updateAutofeedSettings(params: Params$Resource$Accounts$Autofeedsettings$Updateautofeedsettings, options: StreamMethodOptions): GaxiosPromise<Readable>;
1856
+ updateAutofeedSettings(params?: Params$Resource$Accounts$Autofeedsettings$Updateautofeedsettings, options?: MethodOptions): GaxiosPromise<Schema$AutofeedSettings>;
1857
+ updateAutofeedSettings(params: Params$Resource$Accounts$Autofeedsettings$Updateautofeedsettings, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
1858
+ updateAutofeedSettings(params: Params$Resource$Accounts$Autofeedsettings$Updateautofeedsettings, options: MethodOptions | BodyResponseCallback<Schema$AutofeedSettings>, callback: BodyResponseCallback<Schema$AutofeedSettings>): void;
1859
+ updateAutofeedSettings(params: Params$Resource$Accounts$Autofeedsettings$Updateautofeedsettings, callback: BodyResponseCallback<Schema$AutofeedSettings>): void;
1860
+ updateAutofeedSettings(callback: BodyResponseCallback<Schema$AutofeedSettings>): void;
1861
+ }
1862
+ export interface Params$Resource$Accounts$Autofeedsettings$Getautofeedsettings extends StandardParameters {
1863
+ /**
1864
+ * Required. The resource name of the autofeed settings. Format: `accounts/{account\}/autofeedSettings`
1865
+ */
1866
+ name?: string;
1867
+ }
1868
+ export interface Params$Resource$Accounts$Autofeedsettings$Updateautofeedsettings extends StandardParameters {
1869
+ /**
1870
+ * Identifier. The resource name of the autofeed settings. Format: `accounts/{account\}/autofeedSettings`.
1871
+ */
1872
+ name?: string;
1873
+ /**
1874
+ * Required. List of fields being updated.
1875
+ */
1876
+ updateMask?: string;
1877
+ /**
1878
+ * Request body metadata
1879
+ */
1880
+ requestBody?: Schema$AutofeedSettings;
1881
+ }
1619
1882
  export class Resource$Accounts$Businessidentity {
1620
1883
  context: APIRequestContext;
1621
1884
  constructor(context: APIRequestContext);
@@ -1660,7 +1923,7 @@ export declare namespace merchantapi_accounts_v1beta {
1660
1923
  */
1661
1924
  name?: string;
1662
1925
  /**
1663
- * Required. List of fields being updated.
1926
+ * Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `black_owned` - `latino_owned` - `promotions_consent` - `small_business` - `veteran_owned` - `women_owned`
1664
1927
  */
1665
1928
  updateMask?: string;
1666
1929
  /**
@@ -1712,7 +1975,7 @@ export declare namespace merchantapi_accounts_v1beta {
1712
1975
  */
1713
1976
  name?: string;
1714
1977
  /**
1715
- * Required. List of fields being updated.
1978
+ * Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `address` - `customer_service` - `korean_business_registration_number`
1716
1979
  */
1717
1980
  updateMask?: string;
1718
1981
  /**
@@ -1724,7 +1987,7 @@ export declare namespace merchantapi_accounts_v1beta {
1724
1987
  context: APIRequestContext;
1725
1988
  constructor(context: APIRequestContext);
1726
1989
  /**
1727
- * Returns the email preferences for a Merchant Center account user. Use the name=accounts/x/users/me/emailPreferences alias to get preferences for the authenticated user.
1990
+ * Returns the email preferences for a Merchant Center account user. This service only permits retrieving and updating email preferences for the authenticated user. Use the name=accounts/x/users/me/emailPreferences alias to get preferences for the authenticated user.
1728
1991
  *
1729
1992
  * @param params - Parameters for request
1730
1993
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1764,7 +2027,7 @@ export declare namespace merchantapi_accounts_v1beta {
1764
2027
  */
1765
2028
  name?: string;
1766
2029
  /**
1767
- * Required. List of fields being updated.
2030
+ * Required. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `news_and_tips`
1768
2031
  */
1769
2032
  updateMask?: string;
1770
2033
  /**
@@ -1864,7 +2127,7 @@ export declare namespace merchantapi_accounts_v1beta {
1864
2127
  */
1865
2128
  name?: string;
1866
2129
  /**
1867
- * Required. List of fields being updated.
2130
+ * Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `uri`
1868
2131
  */
1869
2132
  updateMask?: string;
1870
2133
  /**
@@ -1908,19 +2171,15 @@ export declare namespace merchantapi_accounts_v1beta {
1908
2171
  */
1909
2172
  parent?: string;
1910
2173
  /**
1911
- * IANA Time Zone Database time zone, e.g. "America/New_York".
2174
+ * Optional. The [IANA](https://www.iana.org/time-zones) timezone used to localize times in human-readable fields. For example 'America/Los_Angeles'. If not set, 'America/Los_Angeles' will be used.
1912
2175
  */
1913
- 'timeZone.id'?: string;
1914
- /**
1915
- * Optional. IANA Time Zone Database version number, e.g. "2019a".
1916
- */
1917
- 'timeZone.version'?: string;
2176
+ timeZone?: string;
1918
2177
  }
1919
2178
  export class Resource$Accounts$Onlinereturnpolicies {
1920
2179
  context: APIRequestContext;
1921
2180
  constructor(context: APIRequestContext);
1922
2181
  /**
1923
- * Gets an existing return policy.
2182
+ * Gets an existing return policy for a given merchant.
1924
2183
  *
1925
2184
  * @param params - Parameters for request
1926
2185
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1934,7 +2193,7 @@ export declare namespace merchantapi_accounts_v1beta {
1934
2193
  get(params: Params$Resource$Accounts$Onlinereturnpolicies$Get, callback: BodyResponseCallback<Schema$OnlineReturnPolicy>): void;
1935
2194
  get(callback: BodyResponseCallback<Schema$OnlineReturnPolicy>): void;
1936
2195
  /**
1937
- * Lists all existing return policies.
2196
+ * Lists all existing return policies for a given merchant.
1938
2197
  *
1939
2198
  * @param params - Parameters for request
1940
2199
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2306,7 +2565,7 @@ export declare namespace merchantapi_accounts_v1beta {
2306
2565
  create(params: Params$Resource$Accounts$Users$Create, callback: BodyResponseCallback<Schema$User>): void;
2307
2566
  create(callback: BodyResponseCallback<Schema$User>): void;
2308
2567
  /**
2309
- * Deletes a Merchant Center account user. Executing this method requires admin access.
2568
+ * Deletes a Merchant Center account user. Executing this method requires admin access. The user to be deleted can't be the last admin user of that account. Also a user is protected from deletion if it is managed by Business Manager"
2310
2569
  *
2311
2570
  * @param params - Parameters for request
2312
2571
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2408,7 +2667,7 @@ export declare namespace merchantapi_accounts_v1beta {
2408
2667
  */
2409
2668
  name?: string;
2410
2669
  /**
2411
- * Required. List of fields being updated.
2670
+ * Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `access_rights`
2412
2671
  */
2413
2672
  updateMask?: string;
2414
2673
  /**
@@ -2484,11 +2743,11 @@ export declare namespace merchantapi_accounts_v1beta {
2484
2743
  }
2485
2744
  export interface Params$Resource$Termsofservice$Retrievelatest extends StandardParameters {
2486
2745
  /**
2487
- * The Kind this terms of service version applies to.
2746
+ * Required. The Kind this terms of service version applies to.
2488
2747
  */
2489
2748
  kind?: string;
2490
2749
  /**
2491
- * Region code as defined by [CLDR](https://cldr.unicode.org/). This is either a country when the ToS applies specifically to that country or 001 when it applies globally.
2750
+ * Required. Region code as defined by [CLDR](https://cldr.unicode.org/). This is either a country when the ToS applies specifically to that country or 001 when it applies globally.
2492
2751
  */
2493
2752
  regionCode?: string;
2494
2753
  }