google-apis-merchantapi_accounts_v1beta 0.11.0 → 0.13.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.
@@ -22,23 +22,57 @@ module Google
22
22
  module Apis
23
23
  module MerchantapiAccountsV1beta
24
24
 
25
+ # Collection of information related to the about page ([impressum](https://
26
+ # support.google.com/merchants/answer/14675634?hl=en&ref_topic=15145634&sjid=
27
+ # 6892280366904591178-NC)).
28
+ class About
29
+ include Google::Apis::Core::Hashable
30
+
31
+ # Output only. The state of the URI.
32
+ # Corresponds to the JSON property `state`
33
+ # @return [String]
34
+ attr_accessor :state
35
+
36
+ # Required. The about page URI.
37
+ # Corresponds to the JSON property `uri`
38
+ # @return [String]
39
+ attr_accessor :uri
40
+
41
+ def initialize(**args)
42
+ update!(**args)
43
+ end
44
+
45
+ # Update properties of this object
46
+ def update!(**args)
47
+ @state = args[:state] if args.key?(:state)
48
+ @uri = args[:uri] if args.key?(:uri)
49
+ end
50
+ end
51
+
25
52
  # Response message for the `AcceptTermsOfService` method.
26
53
  class AcceptTermsOfServiceResponse
27
54
  include Google::Apis::Core::Hashable
28
55
 
29
56
  # This resource represents the agreement state for a given account and terms of
30
- # service kind. The state is as follows: * If the merchant has accepted a terms
57
+ # service kind. The state is as follows: * If the business has accepted a terms
31
58
  # of service, `accepted` will be populated, otherwise it will be empty * If the
32
- # merchant must sign a terms of service, `required` will be populated, otherwise
59
+ # business must sign a terms of service, `required` will be populated, otherwise
33
60
  # it will be empty. Note that both `required` and `accepted` can be present. In
34
61
  # this case the `accepted` terms of services will have an expiration date set in
35
62
  # the `valid_until` field. The `required` terms of services need to be accepted
36
63
  # before `valid_until` in order for the account to continue having a valid
37
- # agreement. When accepting new terms of services we expect 3Ps to display the
38
- # text associated with the given terms of service agreement (the url to the file
39
- # containing the text is added in the Required message below as `tos_file_uri`.
40
- # The actual acceptance of the terms of service is done by calling accept on the
41
- # `TermsOfService` resource.
64
+ # agreement. When accepting new terms of services we expect third-party
65
+ # providers to display the text associated with the given terms of service
66
+ # agreement (the url to the file containing the text is added in the Required
67
+ # message below as `tos_file_uri`). The actual acceptance of the terms of
68
+ # service is done by calling accept on the `TermsOfService` resource. `
69
+ # valid_until` field. The `required` terms of services need to be accepted
70
+ # before `valid_until` in order for the account to continue having a valid
71
+ # agreement. When accepting new terms of services, we expect third-party
72
+ # providers to display the text associated with the given terms of service
73
+ # agreement (the url to the file containing the text is added in the Required
74
+ # message below as `tos_file_uri`. The actual acceptance of the terms of service
75
+ # is done by calling accept on the `TermsOfService` resource.
42
76
  # Corresponds to the JSON property `termsOfServiceAgreementState`
43
77
  # @return [Google::Apis::MerchantapiAccountsV1beta::TermsOfServiceAgreementState]
44
78
  attr_accessor :terms_of_service_agreement_state
@@ -53,18 +87,18 @@ module Google
53
87
  end
54
88
  end
55
89
 
56
- # Describes the accepted terms of service.
90
+ # Describes the [accepted terms of service](/merchant/api/guides/accounts/create-
91
+ # and-configure#accept_the_merchant_center_terms_of_service).
57
92
  class Accepted
58
93
  include Google::Apis::Core::Hashable
59
94
 
60
95
  # The account where the acceptance was recorded. This can be the account itself
61
- # or, in the case of subaccounts, the MCA account.
96
+ # or, in the case of subaccounts, the advanced account.
62
97
  # Corresponds to the JSON property `acceptedBy`
63
98
  # @return [String]
64
99
  attr_accessor :accepted_by
65
100
 
66
- # The accepted [termsOfService](google.shopping.merchant.accounts.v1main.
67
- # TermsOfService).
101
+ # The accepted termsOfService.
68
102
  # Corresponds to the JSON property `termsOfService`
69
103
  # @return [String]
70
104
  attr_accessor :terms_of_service
@@ -93,13 +127,13 @@ module Google
93
127
  end
94
128
  end
95
129
 
96
- # The `Account` message represents a merchant's account within Shopping Ads. It'
130
+ # The `Account` message represents a business's account within Shopping Ads. It'
97
131
  # s the primary entity for managing product data, settings, and interactions
98
132
  # with Google's services and external providers. Accounts can operate as
99
- # standalone entities or be part of a multi-client account (MCA) structure. In
100
- # an MCA setup the parent account manages multiple sub-accounts. Establishing an
101
- # account involves configuring attributes like the account name, time zone, and
102
- # language preferences. The `Account` message is the parent entity for many
133
+ # standalone entities or be part of a advanced account structure. In an advanced
134
+ # account setup the parent account manages multiple sub-accounts. Establishing
135
+ # an account involves configuring attributes like the account name, time zone,
136
+ # and language preferences. The `Account` message is the parent entity for many
103
137
  # other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo`
104
138
  # and so on.
105
139
  class Account
@@ -175,8 +209,10 @@ module Google
175
209
  end
176
210
  end
177
211
 
178
- # An [`AccountIssue`](https://support.google.com/merchants/answer/12153802?sjid=
179
- # 17798438912526418908-EU#account).
212
+ # Issues with your Merchant Center account that can impact all your products.
213
+ # For more information, see [Account-level issues in Merchant Center](https://
214
+ # support.google.com/merchants/answer/12153802?sjid=17798438912526418908-EU#
215
+ # account).
180
216
  class AccountIssue
181
217
  include Google::Apis::Core::Hashable
182
218
 
@@ -197,7 +233,8 @@ module Google
197
233
  attr_accessor :impacted_destinations
198
234
 
199
235
  # Identifier. The resource name of the account issue. Format: `accounts/`account`
200
- # /issues/`id``
236
+ # /issues/`id``. For example, `accounts/123456/issues/misrepresentation-of-self-
237
+ # or-products-unacceptable-business-practice-policy`.
201
238
  # Corresponds to the JSON property `name`
202
239
  # @return [String]
203
240
  attr_accessor :name
@@ -227,6 +264,175 @@ module Google
227
264
  end
228
265
  end
229
266
 
267
+ # `AccountManagement` payload.
268
+ class AccountManagement
269
+ include Google::Apis::Core::Hashable
270
+
271
+ def initialize(**args)
272
+ update!(**args)
273
+ end
274
+
275
+ # Update properties of this object
276
+ def update!(**args)
277
+ end
278
+ end
279
+
280
+ # The `AccountRelationship` message defines a formal connection between a
281
+ # merchant's account and a service provider's account. This relationship enables
282
+ # the provider to offer specific services to the business, such as product
283
+ # management or campaign management. It specifies the access rights and
284
+ # permissions to the business's data relevant to those services. Establishing an
285
+ # account relationship involves linking the merchant's account with a provider's
286
+ # account. The provider could be another Google account (like Google Ads or
287
+ # Google My Business) or a third-party platform (such as Shopify or WooCommerce).
288
+ class AccountRelationship
289
+ include Google::Apis::Core::Hashable
290
+
291
+ # Optional. An optional alias you can assign to this account relationship. This
292
+ # alias acts as a convenient identifier for your own reference and management.
293
+ # It must be unique among all your account relationships with the same provider.
294
+ # For example, you might use `account_id_alias` to assign a friendly name to
295
+ # this relationship for easier identification in your systems.
296
+ # Corresponds to the JSON property `accountIdAlias`
297
+ # @return [String]
298
+ attr_accessor :account_id_alias
299
+
300
+ # Identifier. The resource name of the account relationship. Format: `accounts/`
301
+ # account`/relationships/`relationship``. For example, `accounts/123456/
302
+ # relationships/567890`.
303
+ # Corresponds to the JSON property `name`
304
+ # @return [String]
305
+ attr_accessor :name
306
+
307
+ # Immutable. The provider of the service. Either the reference to an account
308
+ # such as `providers/123` or a well-known service provider (one of `providers/
309
+ # GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).
310
+ # Corresponds to the JSON property `provider`
311
+ # @return [String]
312
+ attr_accessor :provider
313
+
314
+ # Output only. The human-readable display name of the provider account.
315
+ # Corresponds to the JSON property `providerDisplayName`
316
+ # @return [String]
317
+ attr_accessor :provider_display_name
318
+
319
+ def initialize(**args)
320
+ update!(**args)
321
+ end
322
+
323
+ # Update properties of this object
324
+ def update!(**args)
325
+ @account_id_alias = args[:account_id_alias] if args.key?(:account_id_alias)
326
+ @name = args[:name] if args.key?(:name)
327
+ @provider = args[:provider] if args.key?(:provider)
328
+ @provider_display_name = args[:provider_display_name] if args.key?(:provider_display_name)
329
+ end
330
+ end
331
+
332
+ # The `AccountService` message represents a specific service that a provider
333
+ # account offers to a Merchant Center account. `AccountService` defines the
334
+ # permissions and capabilities granted to the provider, allowing for operations
335
+ # such as product management or campaign management. The lifecycle of an `
336
+ # AccountService` involves a proposal phase, where one party suggests the
337
+ # service, and an approval phase, where the other party accepts or rejects it.
338
+ # This handshake mechanism ensures mutual consent before any access is granted.
339
+ # This mechanism safeguards both parties by ensuring that access rights are
340
+ # granted appropriately and that both the business and provider are aware of the
341
+ # services enabled. In scenarios where a user is an admin of both accounts, the
342
+ # approval can happen automatically. The mutability of a service is also managed
343
+ # through `AccountService`. Some services might be immutable, for example, if
344
+ # they were established through other systems or APIs, and you cannot alter them
345
+ # through this API.
346
+ class AccountService
347
+ include Google::Apis::Core::Hashable
348
+
349
+ # `AccountAggregation` payload.
350
+ # Corresponds to the JSON property `accountAggregation`
351
+ # @return [Google::Apis::MerchantapiAccountsV1beta::AccountAggregation]
352
+ attr_accessor :account_aggregation
353
+
354
+ # `AccountManagement` payload.
355
+ # Corresponds to the JSON property `accountManagement`
356
+ # @return [Google::Apis::MerchantapiAccountsV1beta::AccountManagement]
357
+ attr_accessor :account_management
358
+
359
+ # `CampaignManagement` payload.
360
+ # Corresponds to the JSON property `campaignsManagement`
361
+ # @return [Google::Apis::MerchantapiAccountsV1beta::CampaignsManagement]
362
+ attr_accessor :campaigns_management
363
+
364
+ # Immutable. An optional, immutable identifier that Google uses to refer to this
365
+ # account when communicating with the provider. This should be the unique
366
+ # account ID within the provider's system (for example, your shop ID in Shopify).
367
+ # If you have multiple accounts with the same provider - for instance,
368
+ # different accounts for various regions — the `external_account_id`
369
+ # differentiates between them, ensuring accurate linking and integration between
370
+ # Google and the provider.
371
+ # Corresponds to the JSON property `externalAccountId`
372
+ # @return [String]
373
+ attr_accessor :external_account_id
374
+
375
+ # The current status of establishing of the service. (for example, pending
376
+ # approval or approved).
377
+ # Corresponds to the JSON property `handshake`
378
+ # @return [Google::Apis::MerchantapiAccountsV1beta::Handshake]
379
+ attr_accessor :handshake
380
+
381
+ # `LocalListingManagement` payload.
382
+ # Corresponds to the JSON property `localListingManagement`
383
+ # @return [Google::Apis::MerchantapiAccountsV1beta::LocalListingManagement]
384
+ attr_accessor :local_listing_management
385
+
386
+ # Output only. Whether the service is mutable (e.g. through Approve / Reject
387
+ # RPCs). A service that was created through another system or API might be
388
+ # immutable.
389
+ # Corresponds to the JSON property `mutability`
390
+ # @return [String]
391
+ attr_accessor :mutability
392
+
393
+ # Identifier. The resource name of the account service. Format: `accounts/`
394
+ # account`/services/`service``
395
+ # Corresponds to the JSON property `name`
396
+ # @return [String]
397
+ attr_accessor :name
398
+
399
+ # `ProductsManagement` payload.
400
+ # Corresponds to the JSON property `productsManagement`
401
+ # @return [Google::Apis::MerchantapiAccountsV1beta::ProductsManagement]
402
+ attr_accessor :products_management
403
+
404
+ # Output only. The provider of the service. Either the reference to an account
405
+ # such as `providers/123` or a well-known service provider (one of `providers/
406
+ # GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).
407
+ # Corresponds to the JSON property `provider`
408
+ # @return [String]
409
+ attr_accessor :provider
410
+
411
+ # Output only. The human-readable display name of the provider account.
412
+ # Corresponds to the JSON property `providerDisplayName`
413
+ # @return [String]
414
+ attr_accessor :provider_display_name
415
+
416
+ def initialize(**args)
417
+ update!(**args)
418
+ end
419
+
420
+ # Update properties of this object
421
+ def update!(**args)
422
+ @account_aggregation = args[:account_aggregation] if args.key?(:account_aggregation)
423
+ @account_management = args[:account_management] if args.key?(:account_management)
424
+ @campaigns_management = args[:campaigns_management] if args.key?(:campaigns_management)
425
+ @external_account_id = args[:external_account_id] if args.key?(:external_account_id)
426
+ @handshake = args[:handshake] if args.key?(:handshake)
427
+ @local_listing_management = args[:local_listing_management] if args.key?(:local_listing_management)
428
+ @mutability = args[:mutability] if args.key?(:mutability)
429
+ @name = args[:name] if args.key?(:name)
430
+ @products_management = args[:products_management] if args.key?(:products_management)
431
+ @provider = args[:provider] if args.key?(:provider)
432
+ @provider_display_name = args[:provider_display_name] if args.key?(:provider_display_name)
433
+ end
434
+ end
435
+
230
436
  # Additional instructions to add account services during creation of the account.
231
437
  class AddAccountService
232
438
  include Google::Apis::Core::Hashable
@@ -328,13 +534,26 @@ module Google
328
534
  end
329
535
  end
330
536
 
537
+ # Request to approve an account service.
538
+ class ApproveAccountServiceRequest
539
+ include Google::Apis::Core::Hashable
540
+
541
+ def initialize(**args)
542
+ update!(**args)
543
+ end
544
+
545
+ # Update properties of this object
546
+ def update!(**args)
547
+ end
548
+ end
549
+
331
550
  # Collection of information related to the [autofeed](https://support.google.com/
332
551
  # merchants/answer/7538732) settings.
333
552
  class AutofeedSettings
334
553
  include Google::Apis::Core::Hashable
335
554
 
336
- # Output only. Determines whether merchant is eligible for being enrolled into
337
- # an autofeed.
555
+ # Output only. Determines whether the business is eligible for being enrolled
556
+ # into an autofeed.
338
557
  # Corresponds to the JSON property `eligible`
339
558
  # @return [Boolean]
340
559
  attr_accessor :eligible
@@ -434,14 +653,15 @@ module Google
434
653
  # @return [String]
435
654
  attr_accessor :name
436
655
 
437
- # Not available for MCAs [accounts](https://support.google.com/merchants/answer/
438
- # 188487). By turning on [automatic shipping improvements](https://support.
439
- # google.com/merchants/answer/10027038), you are allowing Google to improve the
440
- # accuracy of your delivery times shown to shoppers using Google. More accurate
441
- # delivery times, especially when faster, typically lead to better conversion
442
- # rates. Google will improve your estimated delivery times based on various
443
- # factors: * Delivery address of an order * Current handling time and shipping
444
- # time settings * Estimated weekdays or business days * Parcel tracking data
656
+ # Not available for [advanced accounts](https://support.google.com/merchants/
657
+ # answer/188487). By turning on [automatic shipping improvements](https://
658
+ # support.google.com/merchants/answer/10027038), you are allowing Google to
659
+ # improve the accuracy of your delivery times shown to shoppers using Google.
660
+ # More accurate delivery times, especially when faster, typically lead to better
661
+ # conversion rates. Google will improve your estimated delivery times based on
662
+ # various factors: * Delivery address of an order * Current handling time and
663
+ # shipping time settings * Estimated weekdays or business days * Parcel tracking
664
+ # data
445
665
  # Corresponds to the JSON property `shippingImprovements`
446
666
  # @return [Google::Apis::MerchantapiAccountsV1beta::AutomaticShippingImprovements]
447
667
  attr_accessor :shipping_improvements
@@ -522,14 +742,15 @@ module Google
522
742
  end
523
743
  end
524
744
 
525
- # Not available for MCAs [accounts](https://support.google.com/merchants/answer/
526
- # 188487). By turning on [automatic shipping improvements](https://support.
527
- # google.com/merchants/answer/10027038), you are allowing Google to improve the
528
- # accuracy of your delivery times shown to shoppers using Google. More accurate
529
- # delivery times, especially when faster, typically lead to better conversion
530
- # rates. Google will improve your estimated delivery times based on various
531
- # factors: * Delivery address of an order * Current handling time and shipping
532
- # time settings * Estimated weekdays or business days * Parcel tracking data
745
+ # Not available for [advanced accounts](https://support.google.com/merchants/
746
+ # answer/188487). By turning on [automatic shipping improvements](https://
747
+ # support.google.com/merchants/answer/10027038), you are allowing Google to
748
+ # improve the accuracy of your delivery times shown to shoppers using Google.
749
+ # More accurate delivery times, especially when faster, typically lead to better
750
+ # conversion rates. Google will improve your estimated delivery times based on
751
+ # various factors: * Delivery address of an order * Current handling time and
752
+ # shipping time settings * Estimated weekdays or business days * Parcel tracking
753
+ # data
533
754
  class AutomaticShippingImprovements
534
755
  include Google::Apis::Core::Hashable
535
756
 
@@ -625,9 +846,9 @@ module Google
625
846
  end
626
847
  end
627
848
 
628
- # The `BusinessInfo` message contains essential information about a merchant's
629
- # business. This message captures key business details such as physical address,
630
- # customer service contacts, and region-specific identifiers.
849
+ # The `BusinessInfo` message contains essential information about a business.
850
+ # This message captures key business details such as physical address, customer
851
+ # service contacts, and region-specific identifiers.
631
852
  class BusinessInfo
632
853
  include Google::Apis::Core::Hashable
633
854
 
@@ -700,6 +921,19 @@ module Google
700
921
  end
701
922
  end
702
923
 
924
+ # `CampaignManagement` payload.
925
+ class CampaignsManagement
926
+ include Google::Apis::Core::Hashable
927
+
928
+ def initialize(**args)
929
+ update!(**args)
930
+ end
931
+
932
+ # Update properties of this object
933
+ def update!(**args)
934
+ end
935
+ end
936
+
703
937
  # A list of carrier rates that can be referred to by `main_table` or `
704
938
  # single_value`. Supported carrier services are defined in https://support.
705
939
  # google.com/merchants/answer/12577710?ref_topic=12570808&sjid=
@@ -760,8 +994,8 @@ module Google
760
994
  include Google::Apis::Core::Hashable
761
995
 
762
996
  # Optional. When set to `true`, this option removes any existing claim on the
763
- # requested website and replaces it with a claim from the account that makes the
764
- # request.
997
+ # requested website from any other account to the account making the request,
998
+ # effectively replacing the previous claim.
765
999
  # Corresponds to the JSON property `overwrite`
766
1000
  # @return [Boolean]
767
1001
  attr_accessor :overwrite
@@ -781,13 +1015,13 @@ module Google
781
1015
  class CreateAndConfigureAccountRequest
782
1016
  include Google::Apis::Core::Hashable
783
1017
 
784
- # The `Account` message represents a merchant's account within Shopping Ads. It'
1018
+ # The `Account` message represents a business's account within Shopping Ads. It'
785
1019
  # s the primary entity for managing product data, settings, and interactions
786
1020
  # with Google's services and external providers. Accounts can operate as
787
- # standalone entities or be part of a multi-client account (MCA) structure. In
788
- # an MCA setup the parent account manages multiple sub-accounts. Establishing an
789
- # account involves configuring attributes like the account name, time zone, and
790
- # language preferences. The `Account` message is the parent entity for many
1021
+ # standalone entities or be part of a advanced account structure. In an advanced
1022
+ # account setup the parent account manages multiple sub-accounts. Establishing
1023
+ # an account involves configuring attributes like the account name, time zone,
1024
+ # and language preferences. The `Account` message is the parent entity for many
791
1025
  # other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo`
792
1026
  # and so on.
793
1027
  # Corresponds to the JSON property `account`
@@ -797,9 +1031,10 @@ module Google
797
1031
  # Required. An account service between the account to be created and the
798
1032
  # provider account is initialized as part of the creation. At least one such
799
1033
  # service needs to be provided. Currently exactly one of these needs to be `
800
- # account_aggregation`, which means you can only create sub accounts, not
801
- # standalone account through this method. Additional `account_management` or `
802
- # product_management` services may be provided.
1034
+ # account_aggregation` and `accounts.createAndConfigure` method can be used to
1035
+ # create a sub-account under an existing advanced account through this method.
1036
+ # Additional `account_management` or `product_management` services may be
1037
+ # provided.
803
1038
  # Corresponds to the JSON property `service`
804
1039
  # @return [Array<Google::Apis::MerchantapiAccountsV1beta::AddAccountService>]
805
1040
  attr_accessor :service
@@ -915,7 +1150,7 @@ module Google
915
1150
  # @return [Google::Apis::MerchantapiAccountsV1beta::LocalCutoffTime]
916
1151
  attr_accessor :local_cutoff_time
917
1152
 
918
- # Merchants can opt-out of showing n+1 day local delivery when they have a
1153
+ # Businesses can opt-out of showing n+1 day local delivery when they have a
919
1154
  # shipping service configured to n day local delivery. For example, if the
920
1155
  # shipping service defines same-day delivery, and it's past the cut-off, setting
921
1156
  # this field to `true` results in the calculated shipping service rate returning
@@ -1198,6 +1433,77 @@ module Google
1198
1433
  end
1199
1434
  end
1200
1435
 
1436
+ # Response message for the FindLfpProviders method.
1437
+ class FindLfpProvidersResponse
1438
+ include Google::Apis::Core::Hashable
1439
+
1440
+ # The LFP providers from the specified merchant in the specified country.
1441
+ # Corresponds to the JSON property `lfpProviders`
1442
+ # @return [Array<Google::Apis::MerchantapiAccountsV1beta::LfpProvider>]
1443
+ attr_accessor :lfp_providers
1444
+
1445
+ # A token, which can be sent as `page_token` to retrieve the next page. If this
1446
+ # field is omitted, there are no subsequent pages.
1447
+ # Corresponds to the JSON property `nextPageToken`
1448
+ # @return [String]
1449
+ attr_accessor :next_page_token
1450
+
1451
+ def initialize(**args)
1452
+ update!(**args)
1453
+ end
1454
+
1455
+ # Update properties of this object
1456
+ def update!(**args)
1457
+ @lfp_providers = args[:lfp_providers] if args.key?(:lfp_providers)
1458
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
1459
+ end
1460
+ end
1461
+
1462
+ # Collection of information related to a Google Business Profile (GBP) account.
1463
+ class GbpAccount
1464
+ include Google::Apis::Core::Hashable
1465
+
1466
+ # The id of the GBP account.
1467
+ # Corresponds to the JSON property `gbpAccountId`
1468
+ # @return [String]
1469
+ attr_accessor :gbp_account_id
1470
+
1471
+ # The name of the Business Profile. For personal accounts: Email id of the owner.
1472
+ # For Business accounts: Name of the Business Account.
1473
+ # Corresponds to the JSON property `gbpAccountName`
1474
+ # @return [String]
1475
+ attr_accessor :gbp_account_name
1476
+
1477
+ # Number of listings under this account.
1478
+ # Corresponds to the JSON property `listingCount`
1479
+ # @return [Fixnum]
1480
+ attr_accessor :listing_count
1481
+
1482
+ # Identifier. The resource name of the GBP account. Format: `accounts/`account`/
1483
+ # gbpAccount/`gbp_account``
1484
+ # Corresponds to the JSON property `name`
1485
+ # @return [String]
1486
+ attr_accessor :name
1487
+
1488
+ # The type of the Business Profile.
1489
+ # Corresponds to the JSON property `type`
1490
+ # @return [String]
1491
+ attr_accessor :type
1492
+
1493
+ def initialize(**args)
1494
+ update!(**args)
1495
+ end
1496
+
1497
+ # Update properties of this object
1498
+ def update!(**args)
1499
+ @gbp_account_id = args[:gbp_account_id] if args.key?(:gbp_account_id)
1500
+ @gbp_account_name = args[:gbp_account_name] if args.key?(:gbp_account_name)
1501
+ @listing_count = args[:listing_count] if args.key?(:listing_count)
1502
+ @name = args[:name] if args.key?(:name)
1503
+ @type = args[:type] if args.key?(:type)
1504
+ end
1505
+ end
1506
+
1201
1507
  # A list of geotargets that defines the region area.
1202
1508
  class GeoTargetArea
1203
1509
  include Google::Apis::Core::Hashable
@@ -1219,6 +1525,33 @@ module Google
1219
1525
  end
1220
1526
  end
1221
1527
 
1528
+ # The current status of establishing of the service. (for example, pending
1529
+ # approval or approved).
1530
+ class Handshake
1531
+ include Google::Apis::Core::Hashable
1532
+
1533
+ # Output only. The most recent account to modify the account service's `
1534
+ # approval_status`.
1535
+ # Corresponds to the JSON property `actor`
1536
+ # @return [String]
1537
+ attr_accessor :actor
1538
+
1539
+ # Output only. The approval state of this handshake.
1540
+ # Corresponds to the JSON property `approvalState`
1541
+ # @return [String]
1542
+ attr_accessor :approval_state
1543
+
1544
+ def initialize(**args)
1545
+ update!(**args)
1546
+ end
1547
+
1548
+ # Update properties of this object
1549
+ def update!(**args)
1550
+ @actor = args[:actor] if args.key?(:actor)
1551
+ @approval_state = args[:approval_state] if args.key?(:approval_state)
1552
+ end
1553
+ end
1554
+
1222
1555
  # A non-empty list of row or column headers for a table. Exactly one of `prices`,
1223
1556
  # `weights`, `num_items`, `postal_code_group_names`, or `location` must be set.
1224
1557
  class Headers
@@ -1282,10 +1615,10 @@ module Google
1282
1615
  end
1283
1616
  end
1284
1617
 
1285
- # The `Homepage` message represents a merchant's store homepage within the
1286
- # system. A merchant's homepage is the primary domain where customers interact
1618
+ # The `Homepage` message represents a business's store homepage within the
1619
+ # system. A business's homepage is the primary domain where customers interact
1287
1620
  # with their store. The homepage can be claimed and verified as a proof of
1288
- # ownership and allows the merchant to unlock features that require a verified
1621
+ # ownership and allows the business to unlock features that require a verified
1289
1622
  # website. For more information, see [Understanding online store URL
1290
1623
  # verification](//support.google.com/merchants/answer/176793).
1291
1624
  class Homepage
@@ -1344,11 +1677,352 @@ module Google
1344
1677
  class ImageImprovementsAccountLevelSettings
1345
1678
  include Google::Apis::Core::Hashable
1346
1679
 
1347
- # Enables automatic image improvements.
1348
- # Corresponds to the JSON property `allowAutomaticImageImprovements`
1349
- # @return [Boolean]
1350
- attr_accessor :allow_automatic_image_improvements
1351
- alias_method :allow_automatic_image_improvements?, :allow_automatic_image_improvements
1680
+ # Enables automatic image improvements.
1681
+ # Corresponds to the JSON property `allowAutomaticImageImprovements`
1682
+ # @return [Boolean]
1683
+ attr_accessor :allow_automatic_image_improvements
1684
+ alias_method :allow_automatic_image_improvements?, :allow_automatic_image_improvements
1685
+
1686
+ def initialize(**args)
1687
+ update!(**args)
1688
+ end
1689
+
1690
+ # Update properties of this object
1691
+ def update!(**args)
1692
+ @allow_automatic_image_improvements = args[:allow_automatic_image_improvements] if args.key?(:allow_automatic_image_improvements)
1693
+ end
1694
+ end
1695
+
1696
+ # The impact of the issue on a region.
1697
+ class Impact
1698
+ include Google::Apis::Core::Hashable
1699
+
1700
+ # The [CLDR region code](https://cldr.unicode.org/) where this issue applies.
1701
+ # Corresponds to the JSON property `regionCode`
1702
+ # @return [String]
1703
+ attr_accessor :region_code
1704
+
1705
+ # The severity of the issue on the destination and region.
1706
+ # Corresponds to the JSON property `severity`
1707
+ # @return [String]
1708
+ attr_accessor :severity
1709
+
1710
+ def initialize(**args)
1711
+ update!(**args)
1712
+ end
1713
+
1714
+ # Update properties of this object
1715
+ def update!(**args)
1716
+ @region_code = args[:region_code] if args.key?(:region_code)
1717
+ @severity = args[:severity] if args.key?(:severity)
1718
+ end
1719
+ end
1720
+
1721
+ # The impact of the issue on a destination.
1722
+ class ImpactedDestination
1723
+ include Google::Apis::Core::Hashable
1724
+
1725
+ # The (negative) impact for various regions on the given destination.
1726
+ # Corresponds to the JSON property `impacts`
1727
+ # @return [Array<Google::Apis::MerchantapiAccountsV1beta::Impact>]
1728
+ attr_accessor :impacts
1729
+
1730
+ # The impacted reporting context.
1731
+ # Corresponds to the JSON property `reportingContext`
1732
+ # @return [String]
1733
+ attr_accessor :reporting_context
1734
+
1735
+ def initialize(**args)
1736
+ update!(**args)
1737
+ end
1738
+
1739
+ # Update properties of this object
1740
+ def update!(**args)
1741
+ @impacts = args[:impacts] if args.key?(:impacts)
1742
+ @reporting_context = args[:reporting_context] if args.key?(:reporting_context)
1743
+ end
1744
+ end
1745
+
1746
+ # Collection of information related to InStock.
1747
+ class InStock
1748
+ include Google::Apis::Core::Hashable
1749
+
1750
+ # Output only. The state of the in-stock serving.
1751
+ # Corresponds to the JSON property `state`
1752
+ # @return [String]
1753
+ attr_accessor :state
1754
+
1755
+ # Optional. Product landing page URI. It is only used for the review of MHLSF in-
1756
+ # stock serving. This URI domain should match with the business's homepage.
1757
+ # Required to be empty if the lsf_type is GHLSF, and required when the lsf_type
1758
+ # is MHLSF_FULL or MHLSF_BASIC.
1759
+ # Corresponds to the JSON property `uri`
1760
+ # @return [String]
1761
+ attr_accessor :uri
1762
+
1763
+ def initialize(**args)
1764
+ update!(**args)
1765
+ end
1766
+
1767
+ # Update properties of this object
1768
+ def update!(**args)
1769
+ @state = args[:state] if args.key?(:state)
1770
+ @uri = args[:uri] if args.key?(:uri)
1771
+ end
1772
+ end
1773
+
1774
+ # Collection of information related to [inventory verification](https://support.
1775
+ # google.com/merchants/answer/14684499?hl=en&ref_topic=15145634&sjid=
1776
+ # 6892280366904591178-NC).
1777
+ class InventoryVerification
1778
+ include Google::Apis::Core::Hashable
1779
+
1780
+ # Required. The name of the contact for the inventory verification process.
1781
+ # Corresponds to the JSON property `contact`
1782
+ # @return [String]
1783
+ attr_accessor :contact
1784
+
1785
+ # Required. The email address of the contact for the inventory verification
1786
+ # process.
1787
+ # Corresponds to the JSON property `contactEmail`
1788
+ # @return [String]
1789
+ attr_accessor :contact_email
1790
+
1791
+ # Output only. The state of the contact verification.
1792
+ # Corresponds to the JSON property `contactState`
1793
+ # @return [String]
1794
+ attr_accessor :contact_state
1795
+
1796
+ # Output only. The state of the inventory verification process.
1797
+ # Corresponds to the JSON property `state`
1798
+ # @return [String]
1799
+ attr_accessor :state
1800
+
1801
+ def initialize(**args)
1802
+ update!(**args)
1803
+ end
1804
+
1805
+ # Update properties of this object
1806
+ def update!(**args)
1807
+ @contact = args[:contact] if args.key?(:contact)
1808
+ @contact_email = args[:contact_email] if args.key?(:contact_email)
1809
+ @contact_state = args[:contact_state] if args.key?(:contact_state)
1810
+ @state = args[:state] if args.key?(:state)
1811
+ end
1812
+ end
1813
+
1814
+ # Settings for the Automatic Item Updates.
1815
+ class ItemUpdatesAccountLevelSettings
1816
+ include Google::Apis::Core::Hashable
1817
+
1818
+ # If availability updates are enabled, any previous availability values get
1819
+ # overwritten if Google finds an out-of-stock annotation on the offer's page. If
1820
+ # additionally `allow_strict_availability_updates` field is set to true, values
1821
+ # get overwritten if Google finds an in-stock annotation on the offer’s page.
1822
+ # Corresponds to the JSON property `allowAvailabilityUpdates`
1823
+ # @return [Boolean]
1824
+ attr_accessor :allow_availability_updates
1825
+ alias_method :allow_availability_updates?, :allow_availability_updates
1826
+
1827
+ # If condition updates are enabled, Google always updates item condition with
1828
+ # the condition detected from the details of your product.
1829
+ # Corresponds to the JSON property `allowConditionUpdates`
1830
+ # @return [Boolean]
1831
+ attr_accessor :allow_condition_updates
1832
+ alias_method :allow_condition_updates?, :allow_condition_updates
1833
+
1834
+ # If price updates are enabled, Google always updates the active price with the
1835
+ # crawled information.
1836
+ # Corresponds to the JSON property `allowPriceUpdates`
1837
+ # @return [Boolean]
1838
+ attr_accessor :allow_price_updates
1839
+ alias_method :allow_price_updates?, :allow_price_updates
1840
+
1841
+ # If `allow_availability_updates` is enabled, items are automatically updated in
1842
+ # all your Shopping target countries. By default, availability updates will only
1843
+ # be applied to items that are 'out of stock' on your website but 'in stock' on
1844
+ # Shopping. Set this to true to also update items that are 'in stock' on your
1845
+ # website, but 'out of stock' on Google Shopping. In order for this field to
1846
+ # have an effect, you must also set `allow_availability_updates`.
1847
+ # Corresponds to the JSON property `allowStrictAvailabilityUpdates`
1848
+ # @return [Boolean]
1849
+ attr_accessor :allow_strict_availability_updates
1850
+ alias_method :allow_strict_availability_updates?, :allow_strict_availability_updates
1851
+
1852
+ def initialize(**args)
1853
+ update!(**args)
1854
+ end
1855
+
1856
+ # Update properties of this object
1857
+ def update!(**args)
1858
+ @allow_availability_updates = args[:allow_availability_updates] if args.key?(:allow_availability_updates)
1859
+ @allow_condition_updates = args[:allow_condition_updates] if args.key?(:allow_condition_updates)
1860
+ @allow_price_updates = args[:allow_price_updates] if args.key?(:allow_price_updates)
1861
+ @allow_strict_availability_updates = args[:allow_strict_availability_updates] if args.key?(:allow_strict_availability_updates)
1862
+ end
1863
+ end
1864
+
1865
+ # Collection of information related to the LFP link.
1866
+ class LfpLink
1867
+ include Google::Apis::Core::Hashable
1868
+
1869
+ # Required. The account ID by which this merchant is known to the LFP provider.
1870
+ # Corresponds to the JSON property `externalAccountId`
1871
+ # @return [String]
1872
+ attr_accessor :external_account_id
1873
+
1874
+ # Required. The resource name of the LFP provider. Format: `lfpProviders/`
1875
+ # lfp_provider``
1876
+ # Corresponds to the JSON property `lfpProvider`
1877
+ # @return [String]
1878
+ attr_accessor :lfp_provider
1879
+
1880
+ # Output only. The state of the LFP link.
1881
+ # Corresponds to the JSON property `state`
1882
+ # @return [String]
1883
+ attr_accessor :state
1884
+
1885
+ def initialize(**args)
1886
+ update!(**args)
1887
+ end
1888
+
1889
+ # Update properties of this object
1890
+ def update!(**args)
1891
+ @external_account_id = args[:external_account_id] if args.key?(:external_account_id)
1892
+ @lfp_provider = args[:lfp_provider] if args.key?(:lfp_provider)
1893
+ @state = args[:state] if args.key?(:state)
1894
+ end
1895
+ end
1896
+
1897
+ # Collection of information related to a Local Feed Partnership (LFP) provider.
1898
+ class LfpProvider
1899
+ include Google::Apis::Core::Hashable
1900
+
1901
+ # The display name of the LFP provider.
1902
+ # Corresponds to the JSON property `displayName`
1903
+ # @return [String]
1904
+ attr_accessor :display_name
1905
+
1906
+ # Identifier. The resource name of the LFP provider. Format: `accounts/`account`/
1907
+ # omnichannelSettings/`omnichannel_setting`/lfpProviders/`lfp_provider``
1908
+ # Corresponds to the JSON property `name`
1909
+ # @return [String]
1910
+ attr_accessor :name
1911
+
1912
+ # Output only. Region code defined by [CLDR](https://cldr.unicode.org/).
1913
+ # Corresponds to the JSON property `regionCode`
1914
+ # @return [String]
1915
+ attr_accessor :region_code
1916
+
1917
+ def initialize(**args)
1918
+ update!(**args)
1919
+ end
1920
+
1921
+ # Update properties of this object
1922
+ def update!(**args)
1923
+ @display_name = args[:display_name] if args.key?(:display_name)
1924
+ @name = args[:name] if args.key?(:name)
1925
+ @region_code = args[:region_code] if args.key?(:region_code)
1926
+ end
1927
+ end
1928
+
1929
+ # Request message for the LinkGbpAccount method.
1930
+ class LinkGbpAccountRequest
1931
+ include Google::Apis::Core::Hashable
1932
+
1933
+ # Required. The email address of the Business Profile account.
1934
+ # Corresponds to the JSON property `gbpEmail`
1935
+ # @return [String]
1936
+ attr_accessor :gbp_email
1937
+
1938
+ def initialize(**args)
1939
+ update!(**args)
1940
+ end
1941
+
1942
+ # Update properties of this object
1943
+ def update!(**args)
1944
+ @gbp_email = args[:gbp_email] if args.key?(:gbp_email)
1945
+ end
1946
+ end
1947
+
1948
+ # Response message for the LinkGbpAccount method.
1949
+ class LinkGbpAccountResponse
1950
+ include Google::Apis::Core::Hashable
1951
+
1952
+ # A generic empty message that you can re-use to avoid defining duplicated empty
1953
+ # messages in your APIs. A typical example is to use it as the request or the
1954
+ # response type of an API method. For instance: service Foo ` rpc Bar(google.
1955
+ # protobuf.Empty) returns (google.protobuf.Empty); `
1956
+ # Corresponds to the JSON property `response`
1957
+ # @return [Google::Apis::MerchantapiAccountsV1beta::Empty]
1958
+ attr_accessor :response
1959
+
1960
+ def initialize(**args)
1961
+ update!(**args)
1962
+ end
1963
+
1964
+ # Update properties of this object
1965
+ def update!(**args)
1966
+ @response = args[:response] if args.key?(:response)
1967
+ end
1968
+ end
1969
+
1970
+ # Request message for the LinkLfpProvider method.
1971
+ class LinkLfpProviderRequest
1972
+ include Google::Apis::Core::Hashable
1973
+
1974
+ # Required. The external account ID by which this merchant is known to the LFP
1975
+ # provider.
1976
+ # Corresponds to the JSON property `externalAccountId`
1977
+ # @return [String]
1978
+ attr_accessor :external_account_id
1979
+
1980
+ def initialize(**args)
1981
+ update!(**args)
1982
+ end
1983
+
1984
+ # Update properties of this object
1985
+ def update!(**args)
1986
+ @external_account_id = args[:external_account_id] if args.key?(:external_account_id)
1987
+ end
1988
+ end
1989
+
1990
+ # Response message for the LinkLfpProvider method.
1991
+ class LinkLfpProviderResponse
1992
+ include Google::Apis::Core::Hashable
1993
+
1994
+ # A generic empty message that you can re-use to avoid defining duplicated empty
1995
+ # messages in your APIs. A typical example is to use it as the request or the
1996
+ # response type of an API method. For instance: service Foo ` rpc Bar(google.
1997
+ # protobuf.Empty) returns (google.protobuf.Empty); `
1998
+ # Corresponds to the JSON property `response`
1999
+ # @return [Google::Apis::MerchantapiAccountsV1beta::Empty]
2000
+ attr_accessor :response
2001
+
2002
+ def initialize(**args)
2003
+ update!(**args)
2004
+ end
2005
+
2006
+ # Update properties of this object
2007
+ def update!(**args)
2008
+ @response = args[:response] if args.key?(:response)
2009
+ end
2010
+ end
2011
+
2012
+ # Response message for the `ListAccountIssues` method.
2013
+ class ListAccountIssuesResponse
2014
+ include Google::Apis::Core::Hashable
2015
+
2016
+ # The issues from the specified account.
2017
+ # Corresponds to the JSON property `accountIssues`
2018
+ # @return [Array<Google::Apis::MerchantapiAccountsV1beta::AccountIssue>]
2019
+ attr_accessor :account_issues
2020
+
2021
+ # A token, which can be sent as `page_token` to retrieve the next page. If this
2022
+ # field is omitted, there are no subsequent pages.
2023
+ # Corresponds to the JSON property `nextPageToken`
2024
+ # @return [String]
2025
+ attr_accessor :next_page_token
1352
2026
 
1353
2027
  def initialize(**args)
1354
2028
  update!(**args)
@@ -1356,23 +2030,25 @@ module Google
1356
2030
 
1357
2031
  # Update properties of this object
1358
2032
  def update!(**args)
1359
- @allow_automatic_image_improvements = args[:allow_automatic_image_improvements] if args.key?(:allow_automatic_image_improvements)
2033
+ @account_issues = args[:account_issues] if args.key?(:account_issues)
2034
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
1360
2035
  end
1361
2036
  end
1362
2037
 
1363
- # The impact of the issue on a region.
1364
- class Impact
2038
+ # Response after trying to list account relationships.
2039
+ class ListAccountRelationshipsResponse
1365
2040
  include Google::Apis::Core::Hashable
1366
2041
 
1367
- # The [CLDR region code](https://cldr.unicode.org/) where this issue applies.
1368
- # Corresponds to the JSON property `regionCode`
1369
- # @return [String]
1370
- attr_accessor :region_code
2042
+ # The account relationships that match your filter.
2043
+ # Corresponds to the JSON property `accountRelationships`
2044
+ # @return [Array<Google::Apis::MerchantapiAccountsV1beta::AccountRelationship>]
2045
+ attr_accessor :account_relationships
1371
2046
 
1372
- # The severity of the issue on the destination and region.
1373
- # Corresponds to the JSON property `severity`
2047
+ # A page token. You can send the `page_token` to get the next page. Only
2048
+ # included in the `list` response if there are more pages.
2049
+ # Corresponds to the JSON property `nextPageToken`
1374
2050
  # @return [String]
1375
- attr_accessor :severity
2051
+ attr_accessor :next_page_token
1376
2052
 
1377
2053
  def initialize(**args)
1378
2054
  update!(**args)
@@ -1380,24 +2056,25 @@ module Google
1380
2056
 
1381
2057
  # Update properties of this object
1382
2058
  def update!(**args)
1383
- @region_code = args[:region_code] if args.key?(:region_code)
1384
- @severity = args[:severity] if args.key?(:severity)
2059
+ @account_relationships = args[:account_relationships] if args.key?(:account_relationships)
2060
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
1385
2061
  end
1386
2062
  end
1387
2063
 
1388
- # The impact of the issue on a destination.
1389
- class ImpactedDestination
2064
+ # Response after trying to list account services.
2065
+ class ListAccountServicesResponse
1390
2066
  include Google::Apis::Core::Hashable
1391
2067
 
1392
- # The (negative) impact for various regions on the given destination.
1393
- # Corresponds to the JSON property `impacts`
1394
- # @return [Array<Google::Apis::MerchantapiAccountsV1beta::Impact>]
1395
- attr_accessor :impacts
2068
+ # The account services that match your filter.
2069
+ # Corresponds to the JSON property `accountServices`
2070
+ # @return [Array<Google::Apis::MerchantapiAccountsV1beta::AccountService>]
2071
+ attr_accessor :account_services
1396
2072
 
1397
- # The impacted reporting context.
1398
- # Corresponds to the JSON property `reportingContext`
2073
+ # A page token. You can send the `page_token` to get the next page. Only
2074
+ # included in the `list` response if there are more pages.
2075
+ # Corresponds to the JSON property `nextPageToken`
1399
2076
  # @return [String]
1400
- attr_accessor :reporting_context
2077
+ attr_accessor :next_page_token
1401
2078
 
1402
2079
  def initialize(**args)
1403
2080
  update!(**args)
@@ -1405,48 +2082,25 @@ module Google
1405
2082
 
1406
2083
  # Update properties of this object
1407
2084
  def update!(**args)
1408
- @impacts = args[:impacts] if args.key?(:impacts)
1409
- @reporting_context = args[:reporting_context] if args.key?(:reporting_context)
2085
+ @account_services = args[:account_services] if args.key?(:account_services)
2086
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
1410
2087
  end
1411
2088
  end
1412
2089
 
1413
- # Settings for the Automatic Item Updates.
1414
- class ItemUpdatesAccountLevelSettings
2090
+ # Response message for the `ListAccounts` method.
2091
+ class ListAccountsResponse
1415
2092
  include Google::Apis::Core::Hashable
1416
2093
 
1417
- # If availability updates are enabled, any previous availability values get
1418
- # overwritten if Google finds an out-of-stock annotation on the offer's page. If
1419
- # additionally `allow_strict_availability_updates` field is set to true, values
1420
- # get overwritten if Google finds an in-stock annotation on the offer’s page.
1421
- # Corresponds to the JSON property `allowAvailabilityUpdates`
1422
- # @return [Boolean]
1423
- attr_accessor :allow_availability_updates
1424
- alias_method :allow_availability_updates?, :allow_availability_updates
1425
-
1426
- # If condition updates are enabled, Google always updates item condition with
1427
- # the condition detected from the details of your product.
1428
- # Corresponds to the JSON property `allowConditionUpdates`
1429
- # @return [Boolean]
1430
- attr_accessor :allow_condition_updates
1431
- alias_method :allow_condition_updates?, :allow_condition_updates
1432
-
1433
- # If price updates are enabled, Google always updates the active price with the
1434
- # crawled information.
1435
- # Corresponds to the JSON property `allowPriceUpdates`
1436
- # @return [Boolean]
1437
- attr_accessor :allow_price_updates
1438
- alias_method :allow_price_updates?, :allow_price_updates
2094
+ # The accounts matching the `ListAccountsRequest`.
2095
+ # Corresponds to the JSON property `accounts`
2096
+ # @return [Array<Google::Apis::MerchantapiAccountsV1beta::Account>]
2097
+ attr_accessor :accounts
1439
2098
 
1440
- # If `allow_availability_updates` is enabled, items are automatically updated in
1441
- # all your Shopping target countries. By default, availability updates will only
1442
- # be applied to items that are 'out of stock' on your website but 'in stock' on
1443
- # Shopping. Set this to true to also update items that are 'in stock' on your
1444
- # website, but 'out of stock' on Google Shopping. In order for this field to
1445
- # have an effect, you must also set `allow_availability_updates`.
1446
- # Corresponds to the JSON property `allowStrictAvailabilityUpdates`
1447
- # @return [Boolean]
1448
- attr_accessor :allow_strict_availability_updates
1449
- alias_method :allow_strict_availability_updates?, :allow_strict_availability_updates
2099
+ # A token, which can be sent as `page_token` to retrieve the next page. If this
2100
+ # field is omitted, there are no subsequent pages.
2101
+ # Corresponds to the JSON property `nextPageToken`
2102
+ # @return [String]
2103
+ attr_accessor :next_page_token
1450
2104
 
1451
2105
  def initialize(**args)
1452
2106
  update!(**args)
@@ -1454,21 +2108,19 @@ module Google
1454
2108
 
1455
2109
  # Update properties of this object
1456
2110
  def update!(**args)
1457
- @allow_availability_updates = args[:allow_availability_updates] if args.key?(:allow_availability_updates)
1458
- @allow_condition_updates = args[:allow_condition_updates] if args.key?(:allow_condition_updates)
1459
- @allow_price_updates = args[:allow_price_updates] if args.key?(:allow_price_updates)
1460
- @allow_strict_availability_updates = args[:allow_strict_availability_updates] if args.key?(:allow_strict_availability_updates)
2111
+ @accounts = args[:accounts] if args.key?(:accounts)
2112
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
1461
2113
  end
1462
2114
  end
1463
2115
 
1464
- # Response message for the `ListAccountIssues` method.
1465
- class ListAccountIssuesResponse
2116
+ # Response message for the ListGbpAccounts method.
2117
+ class ListGbpAccountsResponse
1466
2118
  include Google::Apis::Core::Hashable
1467
2119
 
1468
- # The issues from the specified account.
1469
- # Corresponds to the JSON property `accountIssues`
1470
- # @return [Array<Google::Apis::MerchantapiAccountsV1beta::AccountIssue>]
1471
- attr_accessor :account_issues
2120
+ # The GBP accounts from the specified merchant in the specified country.
2121
+ # Corresponds to the JSON property `gbpAccounts`
2122
+ # @return [Array<Google::Apis::MerchantapiAccountsV1beta::GbpAccount>]
2123
+ attr_accessor :gbp_accounts
1472
2124
 
1473
2125
  # A token, which can be sent as `page_token` to retrieve the next page. If this
1474
2126
  # field is omitted, there are no subsequent pages.
@@ -1482,34 +2134,34 @@ module Google
1482
2134
 
1483
2135
  # Update properties of this object
1484
2136
  def update!(**args)
1485
- @account_issues = args[:account_issues] if args.key?(:account_issues)
2137
+ @gbp_accounts = args[:gbp_accounts] if args.key?(:gbp_accounts)
1486
2138
  @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
1487
2139
  end
1488
2140
  end
1489
2141
 
1490
- # Response message for the `ListAccounts` method.
1491
- class ListAccountsResponse
2142
+ # Response message for the ListOmnichannelSettings method.
2143
+ class ListOmnichannelSettingsResponse
1492
2144
  include Google::Apis::Core::Hashable
1493
2145
 
1494
- # The accounts matching the `ListAccountsRequest`.
1495
- # Corresponds to the JSON property `accounts`
1496
- # @return [Array<Google::Apis::MerchantapiAccountsV1beta::Account>]
1497
- attr_accessor :accounts
1498
-
1499
2146
  # A token, which can be sent as `page_token` to retrieve the next page. If this
1500
2147
  # field is omitted, there are no subsequent pages.
1501
2148
  # Corresponds to the JSON property `nextPageToken`
1502
2149
  # @return [String]
1503
2150
  attr_accessor :next_page_token
1504
2151
 
2152
+ # The omnichannel settings from the specified merchant.
2153
+ # Corresponds to the JSON property `omnichannelSettings`
2154
+ # @return [Array<Google::Apis::MerchantapiAccountsV1beta::OmnichannelSetting>]
2155
+ attr_accessor :omnichannel_settings
2156
+
1505
2157
  def initialize(**args)
1506
2158
  update!(**args)
1507
2159
  end
1508
2160
 
1509
2161
  # Update properties of this object
1510
2162
  def update!(**args)
1511
- @accounts = args[:accounts] if args.key?(:accounts)
1512
2163
  @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
2164
+ @omnichannel_settings = args[:omnichannel_settings] if args.key?(:omnichannel_settings)
1513
2165
  end
1514
2166
  end
1515
2167
 
@@ -1575,7 +2227,7 @@ module Google
1575
2227
  # @return [String]
1576
2228
  attr_accessor :next_page_token
1577
2229
 
1578
- # The regions from the specified merchant.
2230
+ # The regions from the specified business.
1579
2231
  # Corresponds to the JSON property `regions`
1580
2232
  # @return [Array<Google::Apis::MerchantapiAccountsV1beta::Region>]
1581
2233
  attr_accessor :regions
@@ -1668,6 +2320,19 @@ module Google
1668
2320
  end
1669
2321
  end
1670
2322
 
2323
+ # `LocalListingManagement` payload.
2324
+ class LocalListingManagement
2325
+ include Google::Apis::Core::Hashable
2326
+
2327
+ def initialize(**args)
2328
+ update!(**args)
2329
+ end
2330
+
2331
+ # Update properties of this object
2332
+ def update!(**args)
2333
+ end
2334
+ end
2335
+
1671
2336
  # A list of location ID sets. Must be non-empty. Can only be set if all other
1672
2337
  # fields are not set.
1673
2338
  class LocationIdSet
@@ -1691,7 +2356,7 @@ module Google
1691
2356
  end
1692
2357
 
1693
2358
  # [Loyalty program](https://support.google.com/merchants/answer/12922446)
1694
- # provided by a merchant.
2359
+ # provided by a business.
1695
2360
  class LoyaltyProgram
1696
2361
  include Google::Apis::Core::Hashable
1697
2362
 
@@ -1718,7 +2383,7 @@ module Google
1718
2383
  end
1719
2384
  end
1720
2385
 
1721
- # Subset of a merchants loyalty program.
2386
+ # Subset of a business's loyalty program.
1722
2387
  class LoyaltyProgramTiers
1723
2388
  include Google::Apis::Core::Hashable
1724
2389
 
@@ -1762,21 +2427,123 @@ module Google
1762
2427
  end
1763
2428
  end
1764
2429
 
2430
+ # Collection of information related to the omnichannel settings of a merchant.
2431
+ class OmnichannelSetting
2432
+ include Google::Apis::Core::Hashable
2433
+
2434
+ # Collection of information related to the about page ([impressum](https://
2435
+ # support.google.com/merchants/answer/14675634?hl=en&ref_topic=15145634&sjid=
2436
+ # 6892280366904591178-NC)).
2437
+ # Corresponds to the JSON property `about`
2438
+ # @return [Google::Apis::MerchantapiAccountsV1beta::About]
2439
+ attr_accessor :about
2440
+
2441
+ # Collection of information related to InStock.
2442
+ # Corresponds to the JSON property `inStock`
2443
+ # @return [Google::Apis::MerchantapiAccountsV1beta::InStock]
2444
+ attr_accessor :in_stock
2445
+
2446
+ # Collection of information related to [inventory verification](https://support.
2447
+ # google.com/merchants/answer/14684499?hl=en&ref_topic=15145634&sjid=
2448
+ # 6892280366904591178-NC).
2449
+ # Corresponds to the JSON property `inventoryVerification`
2450
+ # @return [Google::Apis::MerchantapiAccountsV1beta::InventoryVerification]
2451
+ attr_accessor :inventory_verification
2452
+
2453
+ # Collection of information related to the LFP link.
2454
+ # Corresponds to the JSON property `lfpLink`
2455
+ # @return [Google::Apis::MerchantapiAccountsV1beta::LfpLink]
2456
+ attr_accessor :lfp_link
2457
+
2458
+ # Required. The Local Store Front type for this country.
2459
+ # Corresponds to the JSON property `lsfType`
2460
+ # @return [String]
2461
+ attr_accessor :lsf_type
2462
+
2463
+ # Identifier. The resource name of the omnichannel setting. Format: `accounts/`
2464
+ # account`/omnichannelSettings/`omnichannel_setting``
2465
+ # Corresponds to the JSON property `name`
2466
+ # @return [String]
2467
+ attr_accessor :name
2468
+
2469
+ # Collection of information related to the on display to order ([ODO](https://
2470
+ # support.google.com/merchants/answer/14615056?hl=en&ref_topic=15145747&sjid=
2471
+ # 6892280366904591178-NC)).
2472
+ # Corresponds to the JSON property `odo`
2473
+ # @return [Google::Apis::MerchantapiAccountsV1beta::OnDisplayToOrder]
2474
+ attr_accessor :odo
2475
+
2476
+ # Collection of information related to Pickup.
2477
+ # Corresponds to the JSON property `pickup`
2478
+ # @return [Google::Apis::MerchantapiAccountsV1beta::Pickup]
2479
+ attr_accessor :pickup
2480
+
2481
+ # Required. Immutable. Region code defined by [CLDR](https://cldr.unicode.org/).
2482
+ # Must be provided in the Create method, and is immutable.
2483
+ # Corresponds to the JSON property `regionCode`
2484
+ # @return [String]
2485
+ attr_accessor :region_code
2486
+
2487
+ def initialize(**args)
2488
+ update!(**args)
2489
+ end
2490
+
2491
+ # Update properties of this object
2492
+ def update!(**args)
2493
+ @about = args[:about] if args.key?(:about)
2494
+ @in_stock = args[:in_stock] if args.key?(:in_stock)
2495
+ @inventory_verification = args[:inventory_verification] if args.key?(:inventory_verification)
2496
+ @lfp_link = args[:lfp_link] if args.key?(:lfp_link)
2497
+ @lsf_type = args[:lsf_type] if args.key?(:lsf_type)
2498
+ @name = args[:name] if args.key?(:name)
2499
+ @odo = args[:odo] if args.key?(:odo)
2500
+ @pickup = args[:pickup] if args.key?(:pickup)
2501
+ @region_code = args[:region_code] if args.key?(:region_code)
2502
+ end
2503
+ end
2504
+
2505
+ # Collection of information related to the on display to order ([ODO](https://
2506
+ # support.google.com/merchants/answer/14615056?hl=en&ref_topic=15145747&sjid=
2507
+ # 6892280366904591178-NC)).
2508
+ class OnDisplayToOrder
2509
+ include Google::Apis::Core::Hashable
2510
+
2511
+ # Output only. The state of the URI.
2512
+ # Corresponds to the JSON property `state`
2513
+ # @return [String]
2514
+ attr_accessor :state
2515
+
2516
+ # Required. The on display to order (ODO) policy URI.
2517
+ # Corresponds to the JSON property `uri`
2518
+ # @return [String]
2519
+ attr_accessor :uri
2520
+
2521
+ def initialize(**args)
2522
+ update!(**args)
2523
+ end
2524
+
2525
+ # Update properties of this object
2526
+ def update!(**args)
2527
+ @state = args[:state] if args.key?(:state)
2528
+ @uri = args[:uri] if args.key?(:uri)
2529
+ end
2530
+ end
2531
+
1765
2532
  # [Online return policy](https://support.google.com/merchants/answer/10220642)
1766
2533
  # object. This is currently used to represent return policies for ads and free
1767
2534
  # listings programs.
1768
2535
  class OnlineReturnPolicy
1769
2536
  include Google::Apis::Core::Hashable
1770
2537
 
1771
- # This field specifies if merchant only accepts defective products for returns,
1772
- # and this field is required.
2538
+ # Optional. This field specifies if business only accepts defective products for
2539
+ # returns.
1773
2540
  # Corresponds to the JSON property `acceptDefectiveOnly`
1774
2541
  # @return [Boolean]
1775
2542
  attr_accessor :accept_defective_only
1776
2543
  alias_method :accept_defective_only?, :accept_defective_only
1777
2544
 
1778
- # This field specifies if merchant allows customers to exchange products, this
1779
- # field is required.
2545
+ # Optional. This field specifies if business allows customers to exchange
2546
+ # products.
1780
2547
  # Corresponds to the JSON property `acceptExchange`
1781
2548
  # @return [Boolean]
1782
2549
  attr_accessor :accept_exchange
@@ -1816,8 +2583,8 @@ module Google
1816
2583
  # @return [Google::Apis::MerchantapiAccountsV1beta::Policy]
1817
2584
  attr_accessor :policy
1818
2585
 
1819
- # The field specifies the number of days it takes for merchants to process
1820
- # refunds, field is optional.
2586
+ # Optional. The field specifies the number of days it takes for business to
2587
+ # process refunds.
1821
2588
  # Corresponds to the JSON property `processRefundDays`
1822
2589
  # @return [Fixnum]
1823
2590
  attr_accessor :process_refund_days
@@ -1827,8 +2594,7 @@ module Google
1827
2594
  # @return [Google::Apis::MerchantapiAccountsV1beta::RestockingFee]
1828
2595
  attr_accessor :restocking_fee
1829
2596
 
1830
- # The field specifies the return label source. This field is required when
1831
- # return method is BY_MAIL.
2597
+ # Optional. The field specifies the return label source.
1832
2598
  # Corresponds to the JSON property `returnLabelSource`
1833
2599
  # @return [String]
1834
2600
  attr_accessor :return_label_source
@@ -1950,6 +2716,32 @@ module Google
1950
2716
  end
1951
2717
  end
1952
2718
 
2719
+ # Collection of information related to Pickup.
2720
+ class Pickup
2721
+ include Google::Apis::Core::Hashable
2722
+
2723
+ # Output only. The state of the pickup serving.
2724
+ # Corresponds to the JSON property `state`
2725
+ # @return [String]
2726
+ attr_accessor :state
2727
+
2728
+ # Required. Pickup product page URI. It is only used for the review of pickup
2729
+ # serving. This URI domain should match with the business's homepage.
2730
+ # Corresponds to the JSON property `uri`
2731
+ # @return [String]
2732
+ attr_accessor :uri
2733
+
2734
+ def initialize(**args)
2735
+ update!(**args)
2736
+ end
2737
+
2738
+ # Update properties of this object
2739
+ def update!(**args)
2740
+ @state = args[:state] if args.key?(:state)
2741
+ @uri = args[:uri] if args.key?(:uri)
2742
+ end
2743
+ end
2744
+
1953
2745
  # The available policies.
1954
2746
  class Policy
1955
2747
  include Google::Apis::Core::Hashable
@@ -2320,14 +3112,26 @@ module Google
2320
3112
  end
2321
3113
  end
2322
3114
 
3115
+ # `ProductsManagement` payload.
3116
+ class ProductsManagement
3117
+ include Google::Apis::Core::Hashable
3118
+
3119
+ def initialize(**args)
3120
+ update!(**args)
3121
+ end
3122
+
3123
+ # Update properties of this object
3124
+ def update!(**args)
3125
+ end
3126
+ end
3127
+
2323
3128
  # Defines participation in a given program for the specified account. Programs
2324
- # provide a mechanism for adding functionality to merchant accounts. A typical
2325
- # example of this is the [Free product listings](https://support.google.com/
2326
- # merchants/topic/9240261?ref_topic=7257954,7259405,&sjid=796648681813264022-EU)
2327
- # program, which enables products from a merchant's store to be shown across
2328
- # Google for free. The following list is the available set of program resource
2329
- # IDs accessible through the API: * `free-listings` * `shopping-ads` * `youtube-
2330
- # shopping-checkout`
3129
+ # provide a mechanism for adding functionality to a Merchant Center accounts. A
3130
+ # typical example of this is the [Free product listings](https://support.google.
3131
+ # com/merchants/answer/13889434) program, which enables products from a business'
3132
+ # s store to be shown across Google for free. The following list is the
3133
+ # available set of program resource IDs accessible through the API: * `free-
3134
+ # listings` * `shopping-ads` * `youtube-shopping-checkout`
2331
3135
  class Program
2332
3136
  include Google::Apis::Core::Hashable
2333
3137
 
@@ -2376,6 +3180,46 @@ module Google
2376
3180
  end
2377
3181
  end
2378
3182
 
3183
+ # Request to propose an account service.
3184
+ class ProposeAccountServiceRequest
3185
+ include Google::Apis::Core::Hashable
3186
+
3187
+ # The `AccountService` message represents a specific service that a provider
3188
+ # account offers to a Merchant Center account. `AccountService` defines the
3189
+ # permissions and capabilities granted to the provider, allowing for operations
3190
+ # such as product management or campaign management. The lifecycle of an `
3191
+ # AccountService` involves a proposal phase, where one party suggests the
3192
+ # service, and an approval phase, where the other party accepts or rejects it.
3193
+ # This handshake mechanism ensures mutual consent before any access is granted.
3194
+ # This mechanism safeguards both parties by ensuring that access rights are
3195
+ # granted appropriately and that both the business and provider are aware of the
3196
+ # services enabled. In scenarios where a user is an admin of both accounts, the
3197
+ # approval can happen automatically. The mutability of a service is also managed
3198
+ # through `AccountService`. Some services might be immutable, for example, if
3199
+ # they were established through other systems or APIs, and you cannot alter them
3200
+ # through this API.
3201
+ # Corresponds to the JSON property `accountService`
3202
+ # @return [Google::Apis::MerchantapiAccountsV1beta::AccountService]
3203
+ attr_accessor :account_service
3204
+
3205
+ # Required. The provider of the service. Either the reference to an account such
3206
+ # as `providers/123` or a well-known service provider (one of `providers/
3207
+ # GOOGLE_ADS` or `providers/GOOGLE_BUSINESS_PROFILE`).
3208
+ # Corresponds to the JSON property `provider`
3209
+ # @return [String]
3210
+ attr_accessor :provider
3211
+
3212
+ def initialize(**args)
3213
+ update!(**args)
3214
+ end
3215
+
3216
+ # Update properties of this object
3217
+ def update!(**args)
3218
+ @account_service = args[:account_service] if args.key?(:account_service)
3219
+ @provider = args[:provider] if args.key?(:provider)
3220
+ end
3221
+ end
3222
+
2379
3223
  # Shipping rate group definitions. Only the last one is allowed to have an empty
2380
3224
  # `applicable_shipping_labels`, which means "everything else". The other `
2381
3225
  # applicable_shipping_labels` must not overlap.
@@ -2496,6 +3340,51 @@ module Google
2496
3340
  end
2497
3341
  end
2498
3342
 
3343
+ # Request to reject an account service.
3344
+ class RejectAccountServiceRequest
3345
+ include Google::Apis::Core::Hashable
3346
+
3347
+ def initialize(**args)
3348
+ update!(**args)
3349
+ end
3350
+
3351
+ # Update properties of this object
3352
+ def update!(**args)
3353
+ end
3354
+ end
3355
+
3356
+ # Request message for the RequestInventoryVerification method.
3357
+ class RequestInventoryVerificationRequest
3358
+ include Google::Apis::Core::Hashable
3359
+
3360
+ def initialize(**args)
3361
+ update!(**args)
3362
+ end
3363
+
3364
+ # Update properties of this object
3365
+ def update!(**args)
3366
+ end
3367
+ end
3368
+
3369
+ # Response message for the RequestInventoryVerification method.
3370
+ class RequestInventoryVerificationResponse
3371
+ include Google::Apis::Core::Hashable
3372
+
3373
+ # Collection of information related to the omnichannel settings of a merchant.
3374
+ # Corresponds to the JSON property `omnichannelSetting`
3375
+ # @return [Google::Apis::MerchantapiAccountsV1beta::OmnichannelSetting]
3376
+ attr_accessor :omnichannel_setting
3377
+
3378
+ def initialize(**args)
3379
+ update!(**args)
3380
+ end
3381
+
3382
+ # Update properties of this object
3383
+ def update!(**args)
3384
+ @omnichannel_setting = args[:omnichannel_setting] if args.key?(:omnichannel_setting)
3385
+ end
3386
+ end
3387
+
2499
3388
  # Describes the terms of service which are required to be accepted.
2500
3389
  class Required
2501
3390
  include Google::Apis::Core::Hashable
@@ -2747,7 +3636,7 @@ module Google
2747
3636
  # @return [String]
2748
3637
  attr_accessor :service_name
2749
3638
 
2750
- # Type of locations this service ships orders to.
3639
+ # Optional. Type of locations this service ships orders to.
2751
3640
  # Corresponds to the JSON property `shipmentType`
2752
3641
  # @return [String]
2753
3642
  attr_accessor :shipment_type
@@ -2778,8 +3667,10 @@ module Google
2778
3667
  end
2779
3668
  end
2780
3669
 
2781
- # The merchant account's [shipping settings](https://support.google.com/
2782
- # merchants/answer/6069284).
3670
+ # The Merchant Center account's [shipping settings](https://support.google.com/
3671
+ # merchants/answer/6069284). The `ShippingSettings` resource lets you retrieve
3672
+ # and update the shipping settings of your advanced account and all its
3673
+ # associated sub-accounts.
2783
3674
  class ShippingSettings
2784
3675
  include Google::Apis::Core::Hashable
2785
3676
 
@@ -2798,7 +3689,7 @@ module Google
2798
3689
  attr_accessor :etag
2799
3690
 
2800
3691
  # Identifier. The resource name of the shipping settings. Format: `accounts/`
2801
- # account`/shippingSettings`
3692
+ # account`/shippingSettings`. For example, `accounts/123456/shippingSettings`.
2802
3693
  # Corresponds to the JSON property `name`
2803
3694
  # @return [String]
2804
3695
  attr_accessor :name
@@ -2911,7 +3802,7 @@ module Google
2911
3802
  # @return [Array<String>]
2912
3803
  attr_accessor :store_codes
2913
3804
 
2914
- # Indicates whether all stores, or selected stores, listed by this merchant
3805
+ # Indicates whether all stores, or selected stores, listed by this business
2915
3806
  # provide local delivery.
2916
3807
  # Corresponds to the JSON property `storeServiceType`
2917
3808
  # @return [String]
@@ -3030,22 +3921,30 @@ module Google
3030
3921
  end
3031
3922
 
3032
3923
  # This resource represents the agreement state for a given account and terms of
3033
- # service kind. The state is as follows: * If the merchant has accepted a terms
3924
+ # service kind. The state is as follows: * If the business has accepted a terms
3034
3925
  # of service, `accepted` will be populated, otherwise it will be empty * If the
3035
- # merchant must sign a terms of service, `required` will be populated, otherwise
3926
+ # business must sign a terms of service, `required` will be populated, otherwise
3036
3927
  # it will be empty. Note that both `required` and `accepted` can be present. In
3037
3928
  # this case the `accepted` terms of services will have an expiration date set in
3038
3929
  # the `valid_until` field. The `required` terms of services need to be accepted
3039
3930
  # before `valid_until` in order for the account to continue having a valid
3040
- # agreement. When accepting new terms of services we expect 3Ps to display the
3041
- # text associated with the given terms of service agreement (the url to the file
3042
- # containing the text is added in the Required message below as `tos_file_uri`.
3043
- # The actual acceptance of the terms of service is done by calling accept on the
3044
- # `TermsOfService` resource.
3931
+ # agreement. When accepting new terms of services we expect third-party
3932
+ # providers to display the text associated with the given terms of service
3933
+ # agreement (the url to the file containing the text is added in the Required
3934
+ # message below as `tos_file_uri`). The actual acceptance of the terms of
3935
+ # service is done by calling accept on the `TermsOfService` resource. `
3936
+ # valid_until` field. The `required` terms of services need to be accepted
3937
+ # before `valid_until` in order for the account to continue having a valid
3938
+ # agreement. When accepting new terms of services, we expect third-party
3939
+ # providers to display the text associated with the given terms of service
3940
+ # agreement (the url to the file containing the text is added in the Required
3941
+ # message below as `tos_file_uri`. The actual acceptance of the terms of service
3942
+ # is done by calling accept on the `TermsOfService` resource.
3045
3943
  class TermsOfServiceAgreementState
3046
3944
  include Google::Apis::Core::Hashable
3047
3945
 
3048
- # Describes the accepted terms of service.
3946
+ # Describes the [accepted terms of service](/merchant/api/guides/accounts/create-
3947
+ # and-configure#accept_the_merchant_center_terms_of_service).
3049
3948
  # Corresponds to the JSON property `accepted`
3050
3949
  # @return [Google::Apis::MerchantapiAccountsV1beta::Accepted]
3051
3950
  attr_accessor :accepted
@@ -3053,7 +3952,7 @@ module Google
3053
3952
  # Identifier. The resource name of the terms of service version. Format: `
3054
3953
  # accounts/`account`/termsOfServiceAgreementState/`identifier`` The identifier
3055
3954
  # format is: ``TermsOfServiceKind`-`country`` For example, an identifier could
3056
- # be: `MERCHANT_CENTER-US`
3955
+ # be: `MERCHANT_CENTER-EU` or `MERCHANT_CENTER-US`.
3057
3956
  # Corresponds to the JSON property `name`
3058
3957
  # @return [String]
3059
3958
  attr_accessor :name
@@ -3367,7 +4266,8 @@ module Google
3367
4266
  # @return [String]
3368
4267
  attr_accessor :carrier_service
3369
4268
 
3370
- # Required. Warehouse name. This should match warehouse
4269
+ # Required. Warehouse name. This should match [warehouse](/merchant/api/
4270
+ # reference/rest/accounts_v1beta/accounts.shippingSettings#warehouse)
3371
4271
  # Corresponds to the JSON property `warehouse`
3372
4272
  # @return [String]
3373
4273
  attr_accessor :warehouse