google-apis-merchantapi_accounts_v1beta 0.11.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 798b3a1c29d0436e564e9707162d2a577360b89da7979bebaf902c6c0898a38c
-  data.tar.gz: 738039d72353471f73c2532e3a991c60bf4742232e0bc9fcc64aa8720e5aedc5
+  metadata.gz: b7a265e641981de78efbd698759f1012168e359a336b5758b44dfbd517e7006f
+  data.tar.gz: d94d3f67ff9a657340842ba41b34100b882dcf9b46ac66f118e89a4ebef7f3db
 SHA512:
-  metadata.gz: 51423924797dba90c9a887128d11708d00c1790ffafe8574e0b864f7239b8fce2ad8b793179445f8ee9d3d3a885c071c941e419f48ba5fb143024b891e4476df
-  data.tar.gz: 7adc8c929dfe8ef4a4f5653c66a7e7fb44e9d191bb3b9b69a4e01053c649322585cda1d71548e224bc4f0b6ed3d842a3679cafb4616e360758b53d92b93f185e
+  metadata.gz: 29890b5000294d686f540ceb95c58cf0e4d567f7e31f49195f924784ea623fd76e18cbf0c1f84d540e70e51e2cc01d0997272bcf5c2f66326ce8684d2a3c8710
+  data.tar.gz: 927e6de9cfca9cb3a908438c294f2617fe67d451069a1b6955cda10d7b0c160e90156b16048a5786d888ac74dc4f8e399678f293fea739ca5f0a37f320d5091e

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Release history for google-apis-merchantapi_accounts_v1beta
 
+### v0.12.0 (2025-05-11)
+
+* Regenerated from discovery document revision 20250507
+* Regenerated using generator version 0.17.0
+
 ### v0.11.0 (2025-04-27)
 
 * Regenerated from discovery document revision 20250422

data/OVERVIEW.md

@@ -83,7 +83,7 @@ The [product documentation](https://developers.devsite.corp.google.com/merchant/
 
 ## Supported Ruby versions
 
-This library is supported on Ruby 2.7+.
+This library is supported on Ruby 3.1+.
 
 Google provides official support for Ruby versions that are actively supported by Ruby Core -- that is, Ruby versions that are either in normal maintenance or in security maintenance, and not end of life. Older versions of Ruby _may_ still work, but are unsupported and not recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby support schedule.
 

data/lib/google/apis/merchantapi_accounts_v1beta/classes.rb

@@ -36,7 +36,7 @@ module Google
         # before `valid_until` in order for the account to continue having a valid
         # agreement. When accepting new terms of services we expect 3Ps to display the
         # text associated with the given terms of service agreement (the url to the file
-        # containing the text is added in the Required message below as `tos_file_uri`.
+        # containing the text is added in the Required message below as `tos_file_uri`).
         # The actual acceptance of the terms of service is done by calling accept on the
         # `TermsOfService` resource.
         # Corresponds to the JSON property `termsOfServiceAgreementState`
@@ -63,8 +63,7 @@ module Google
         # @return [String]
         attr_accessor :accepted_by
       
-        # The accepted [termsOfService](google.shopping.merchant.accounts.v1main.
-        # TermsOfService).
+        # The accepted termsOfService.
         # Corresponds to the JSON property `termsOfService`
         # @return [String]
         attr_accessor :terms_of_service
@@ -227,6 +226,168 @@ module Google
         end
       end
       
+      # `AccountManagement` payload.
+      class AccountManagement
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # The `AccountRelationship` message defines a formal connection between a
+      # merchant's account and a service provider's account. This relationship enables
+      # the provider to offer specific services to the merchant, such as product
+      # management or campaign management. It specifies the access rights and
+      # permissions to the merchant's data relevant to those services. Establishing an
+      # account relationship involves linking the merchant's account with a provider's
+      # account. The provider could be another Google account (like Google Ads or
+      # Google My Business) or a third-party platform (such as Shopify or WooCommerce).
+      class AccountRelationship
+        include Google::Apis::Core::Hashable
+      
+        # Optional. An optional alias you can assign to this account relationship. This
+        # alias acts as a convenient identifier for your own reference and management.
+        # It must be unique among all your account relationships with the same provider.
+        # For example, you might use `account_id_alias` to assign a friendly name to
+        # this relationship for easier identification in your systems.
+        # Corresponds to the JSON property `accountIdAlias`
+        # @return [String]
+        attr_accessor :account_id_alias
+      
+        # Identifier. The resource name of the account relationship. Format: `accounts/`
+        # account`/relationships/`relationship``
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Immutable. 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`).
+        # Corresponds to the JSON property `provider`
+        # @return [String]
+        attr_accessor :provider
+      
+        # Output only. The human-readable display name of the provider account.
+        # Corresponds to the JSON property `providerDisplayName`
+        # @return [String]
+        attr_accessor :provider_display_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @account_id_alias = args[:account_id_alias] if args.key?(:account_id_alias)
+          @name = args[:name] if args.key?(:name)
+          @provider = args[:provider] if args.key?(:provider)
+          @provider_display_name = args[:provider_display_name] if args.key?(:provider_display_name)
+        end
+      end
+      
+      # The `AccountService` message represents a specific service that a provider
+      # account offers to a merchant account. `AccountService` defines the permissions
+      # and capabilities granted to the provider, allowing for operations such as
+      # product management or campaign management. The lifecycle of an `AccountService`
+      # involves a proposal phase, where one party suggests the service, and an
+      # approval phase, where the other party accepts or rejects it. This handshake
+      # mechanism ensures mutual consent before any access is granted. This mechanism
+      # safeguards both parties by ensuring that access rights are granted
+      # appropriately and that both the merchant and provider are aware of the
+      # services enabled. In scenarios where a user is an admin of both accounts, the
+      # approval can happen automatically. The mutability of a service is also managed
+      # through `AccountService`. Some services might be immutable, for example, if
+      # they were established through other systems or APIs, and you cannot alter them
+      # through this API.
+      class AccountService
+        include Google::Apis::Core::Hashable
+      
+        # `AccountAggregation` payload.
+        # Corresponds to the JSON property `accountAggregation`
+        # @return [Google::Apis::MerchantapiAccountsV1beta::AccountAggregation]
+        attr_accessor :account_aggregation
+      
+        # `AccountManagement` payload.
+        # Corresponds to the JSON property `accountManagement`
+        # @return [Google::Apis::MerchantapiAccountsV1beta::AccountManagement]
+        attr_accessor :account_management
+      
+        # `CampaignManagement` payload.
+        # Corresponds to the JSON property `campaignsManagement`
+        # @return [Google::Apis::MerchantapiAccountsV1beta::CampaignsManagement]
+        attr_accessor :campaigns_management
+      
+        # Immutable. An optional, immutable identifier that Google uses to refer to this
+        # account when communicating with the provider. This should be the unique
+        # account ID within the provider's system (for example, your shop ID in Shopify).
+        # If you have multiple accounts with the same provider - for instance,
+        # different accounts for various regions — the `external_account_id`
+        # differentiates between them, ensuring accurate linking and integration between
+        # Google and the provider.
+        # Corresponds to the JSON property `externalAccountId`
+        # @return [String]
+        attr_accessor :external_account_id
+      
+        # The current status of establishing of the service. (for example, pending
+        # approval or approved).
+        # Corresponds to the JSON property `handshake`
+        # @return [Google::Apis::MerchantapiAccountsV1beta::Handshake]
+        attr_accessor :handshake
+      
+        # Output only. Whether the service is mutable (e.g. through Approve / Reject
+        # RPCs). A service that was created through another system or API might be
+        # immutable.
+        # Corresponds to the JSON property `mutability`
+        # @return [String]
+        attr_accessor :mutability
+      
+        # Identifier. The resource name of the account service. Format: `accounts/`
+        # account`/services/`service``
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # `ProductsManagement` payload.
+        # Corresponds to the JSON property `productsManagement`
+        # @return [Google::Apis::MerchantapiAccountsV1beta::ProductsManagement]
+        attr_accessor :products_management
+      
+        # Output only. 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`).
+        # Corresponds to the JSON property `provider`
+        # @return [String]
+        attr_accessor :provider
+      
+        # Output only. The human-readable display name of the provider account.
+        # Corresponds to the JSON property `providerDisplayName`
+        # @return [String]
+        attr_accessor :provider_display_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @account_aggregation = args[:account_aggregation] if args.key?(:account_aggregation)
+          @account_management = args[:account_management] if args.key?(:account_management)
+          @campaigns_management = args[:campaigns_management] if args.key?(:campaigns_management)
+          @external_account_id = args[:external_account_id] if args.key?(:external_account_id)
+          @handshake = args[:handshake] if args.key?(:handshake)
+          @mutability = args[:mutability] if args.key?(:mutability)
+          @name = args[:name] if args.key?(:name)
+          @products_management = args[:products_management] if args.key?(:products_management)
+          @provider = args[:provider] if args.key?(:provider)
+          @provider_display_name = args[:provider_display_name] if args.key?(:provider_display_name)
+        end
+      end
+      
       # Additional instructions to add account services during creation of the account.
       class AddAccountService
         include Google::Apis::Core::Hashable
@@ -328,6 +489,19 @@ module Google
         end
       end
       
+      # Request to approve an account service.
+      class ApproveAccountServiceRequest
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Collection of information related to the [autofeed](https://support.google.com/
       # merchants/answer/7538732) settings.
       class AutofeedSettings
@@ -700,6 +874,19 @@ module Google
         end
       end
       
+      # `CampaignManagement` payload.
+      class CampaignsManagement
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # 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=
@@ -760,8 +947,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # 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.
+        # requested website from any other account to the account making the request,
+        # effectively replacing the previous claim.
         # Corresponds to the JSON property `overwrite`
         # @return [Boolean]
         attr_accessor :overwrite
@@ -1219,6 +1406,33 @@ module Google
         end
       end
       
+      # The current status of establishing of the service. (for example, pending
+      # approval or approved).
+      class Handshake
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The most recent account to modify the account service's `
+        # approval_status`.
+        # Corresponds to the JSON property `actor`
+        # @return [String]
+        attr_accessor :actor
+      
+        # Output only. The approval state of this handshake.
+        # Corresponds to the JSON property `approvalState`
+        # @return [String]
+        attr_accessor :approval_state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @actor = args[:actor] if args.key?(:actor)
+          @approval_state = args[:approval_state] if args.key?(:approval_state)
+        end
+      end
+      
       # A non-empty list of row or column headers for a table. Exactly one of `prices`,
       # `weights`, `num_items`, `postal_code_group_names`, or `location` must be set.
       class Headers
@@ -1487,6 +1701,58 @@ module Google
         end
       end
       
+      # Response after trying to list account relationships.
+      class ListAccountRelationshipsResponse
+        include Google::Apis::Core::Hashable
+      
+        # The account relationships that match your filter.
+        # Corresponds to the JSON property `accountRelationships`
+        # @return [Array<Google::Apis::MerchantapiAccountsV1beta::AccountRelationship>]
+        attr_accessor :account_relationships
+      
+        # A page token. You can send the `page_token` to get the next page. Only
+        # included in the `list` response if there are more pages.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @account_relationships = args[:account_relationships] if args.key?(:account_relationships)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
+      # Response after trying to list account services.
+      class ListAccountServicesResponse
+        include Google::Apis::Core::Hashable
+      
+        # The account services that match your filter.
+        # Corresponds to the JSON property `accountServices`
+        # @return [Array<Google::Apis::MerchantapiAccountsV1beta::AccountService>]
+        attr_accessor :account_services
+      
+        # A page token. You can send the `page_token` to get the next page. Only
+        # included in the `list` response if there are more pages.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @account_services = args[:account_services] if args.key?(:account_services)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # Response message for the `ListAccounts` method.
       class ListAccountsResponse
         include Google::Apis::Core::Hashable
@@ -1768,15 +2034,15 @@ module Google
       class OnlineReturnPolicy
         include Google::Apis::Core::Hashable
       
-        # This field specifies if merchant only accepts defective products for returns,
-        # and this field is required.
+        # Optional. This field specifies if merchant only accepts defective products for
+        # returns.
         # Corresponds to the JSON property `acceptDefectiveOnly`
         # @return [Boolean]
         attr_accessor :accept_defective_only
         alias_method :accept_defective_only?, :accept_defective_only
       
-        # This field specifies if merchant allows customers to exchange products, this
-        # field is required.
+        # Optional. This field specifies if merchant allows customers to exchange
+        # products.
         # Corresponds to the JSON property `acceptExchange`
         # @return [Boolean]
         attr_accessor :accept_exchange
@@ -1816,8 +2082,8 @@ module Google
         # @return [Google::Apis::MerchantapiAccountsV1beta::Policy]
         attr_accessor :policy
       
-        # The field specifies the number of days it takes for merchants to process
-        # refunds, field is optional.
+        # Optional. The field specifies the number of days it takes for merchants to
+        # process refunds.
         # Corresponds to the JSON property `processRefundDays`
         # @return [Fixnum]
         attr_accessor :process_refund_days
@@ -1827,8 +2093,7 @@ module Google
         # @return [Google::Apis::MerchantapiAccountsV1beta::RestockingFee]
         attr_accessor :restocking_fee
       
-        # The field specifies the return label source. This field is required when
-        # return method is BY_MAIL.
+        # Optional. The field specifies the return label source.
         # Corresponds to the JSON property `returnLabelSource`
         # @return [String]
         attr_accessor :return_label_source
@@ -2320,14 +2585,26 @@ module Google
         end
       end
       
+      # `ProductsManagement` payload.
+      class ProductsManagement
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # 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`
+      # merchants/answer/13889434) 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`
       class Program
         include Google::Apis::Core::Hashable
       
@@ -2376,6 +2653,46 @@ module Google
         end
       end
       
+      # Request to propose an account service.
+      class ProposeAccountServiceRequest
+        include Google::Apis::Core::Hashable
+      
+        # The `AccountService` message represents a specific service that a provider
+        # account offers to a merchant account. `AccountService` defines the permissions
+        # and capabilities granted to the provider, allowing for operations such as
+        # product management or campaign management. The lifecycle of an `AccountService`
+        # involves a proposal phase, where one party suggests the service, and an
+        # approval phase, where the other party accepts or rejects it. This handshake
+        # mechanism ensures mutual consent before any access is granted. This mechanism
+        # safeguards both parties by ensuring that access rights are granted
+        # appropriately and that both the merchant and provider are aware of the
+        # services enabled. In scenarios where a user is an admin of both accounts, the
+        # approval can happen automatically. The mutability of a service is also managed
+        # through `AccountService`. Some services might be immutable, for example, if
+        # they were established through other systems or APIs, and you cannot alter them
+        # through this API.
+        # Corresponds to the JSON property `accountService`
+        # @return [Google::Apis::MerchantapiAccountsV1beta::AccountService]
+        attr_accessor :account_service
+      
+        # 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`).
+        # Corresponds to the JSON property `provider`
+        # @return [String]
+        attr_accessor :provider
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @account_service = args[:account_service] if args.key?(:account_service)
+          @provider = args[:provider] if args.key?(:provider)
+        end
+      end
+      
       # Shipping rate group definitions. Only the last one is allowed to have an empty
       # `applicable_shipping_labels`, which means "everything else". The other `
       # applicable_shipping_labels` must not overlap.
@@ -2496,6 +2813,19 @@ module Google
         end
       end
       
+      # Request to reject an account service.
+      class RejectAccountServiceRequest
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Describes the terms of service which are required to be accepted.
       class Required
         include Google::Apis::Core::Hashable
@@ -3039,7 +3369,7 @@ module Google
       # before `valid_until` in order for the account to continue having a valid
       # agreement. When accepting new terms of services we expect 3Ps to display the
       # text associated with the given terms of service agreement (the url to the file
-      # containing the text is added in the Required message below as `tos_file_uri`.
+      # containing the text is added in the Required message below as `tos_file_uri`).
       # The actual acceptance of the terms of service is done by calling accept on the
       # `TermsOfService` resource.
       class TermsOfServiceAgreementState
@@ -3367,7 +3697,8 @@ module Google
         # @return [String]
         attr_accessor :carrier_service
       
-        # Required. Warehouse name. This should match warehouse
+        # Required. Warehouse name. This should match [warehouse](/merchant/api/
+        # reference/rest/accounts_v1beta/accounts.shippingSettings#warehouse)
         # Corresponds to the JSON property `warehouse`
         # @return [String]
         attr_accessor :warehouse

data/lib/google/apis/merchantapi_accounts_v1beta/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module MerchantapiAccountsV1beta
       # Version of the google-apis-merchantapi_accounts_v1beta gem
-      GEM_VERSION = "0.11.0"
+      GEM_VERSION = "0.12.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.16.0"
+      GENERATOR_VERSION = "0.17.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20250422"
+      REVISION = "20250507"
     end
   end
 end

data/lib/google/apis/merchantapi_accounts_v1beta/representations.rb

@@ -52,6 +52,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class AccountManagement
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AccountRelationship
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AccountService
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class AddAccountService
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -70,6 +88,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ApproveAccountServiceRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class AutofeedSettings
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -118,6 +142,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class CampaignsManagement
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class CarrierRate
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -208,6 +238,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Handshake
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Headers
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -256,6 +292,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ListAccountRelationshipsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ListAccountServicesResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListAccountsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -376,12 +424,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ProductsManagement
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Program
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ProposeAccountServiceRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class RateGroup
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -394,6 +454,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class RejectAccountServiceRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Required
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -595,6 +661,43 @@ module Google
         end
       end
       
+      class AccountManagement
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class AccountRelationship
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :account_id_alias, as: 'accountIdAlias'
+          property :name, as: 'name'
+          property :provider, as: 'provider'
+          property :provider_display_name, as: 'providerDisplayName'
+        end
+      end
+      
+      class AccountService
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :account_aggregation, as: 'accountAggregation', class: Google::Apis::MerchantapiAccountsV1beta::AccountAggregation, decorator: Google::Apis::MerchantapiAccountsV1beta::AccountAggregation::Representation
+      
+          property :account_management, as: 'accountManagement', class: Google::Apis::MerchantapiAccountsV1beta::AccountManagement, decorator: Google::Apis::MerchantapiAccountsV1beta::AccountManagement::Representation
+      
+          property :campaigns_management, as: 'campaignsManagement', class: Google::Apis::MerchantapiAccountsV1beta::CampaignsManagement, decorator: Google::Apis::MerchantapiAccountsV1beta::CampaignsManagement::Representation
+      
+          property :external_account_id, as: 'externalAccountId'
+          property :handshake, as: 'handshake', class: Google::Apis::MerchantapiAccountsV1beta::Handshake, decorator: Google::Apis::MerchantapiAccountsV1beta::Handshake::Representation
+      
+          property :mutability, as: 'mutability'
+          property :name, as: 'name'
+          property :products_management, as: 'productsManagement', class: Google::Apis::MerchantapiAccountsV1beta::ProductsManagement, decorator: Google::Apis::MerchantapiAccountsV1beta::ProductsManagement::Representation
+      
+          property :provider, as: 'provider'
+          property :provider_display_name, as: 'providerDisplayName'
+        end
+      end
+      
       class AddAccountService
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -624,6 +727,12 @@ module Google
         end
       end
       
+      class ApproveAccountServiceRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class AutofeedSettings
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -714,6 +823,12 @@ module Google
         end
       end
       
+      class CampaignsManagement
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class CarrierRate
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -857,6 +972,14 @@ module Google
         end
       end
       
+      class Handshake
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :actor, as: 'actor'
+          property :approval_state, as: 'approvalState'
+        end
+      end
+      
       class Headers
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -930,6 +1053,24 @@ module Google
         end
       end
       
+      class ListAccountRelationshipsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :account_relationships, as: 'accountRelationships', class: Google::Apis::MerchantapiAccountsV1beta::AccountRelationship, decorator: Google::Apis::MerchantapiAccountsV1beta::AccountRelationship::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
+      class ListAccountServicesResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :account_services, as: 'accountServices', class: Google::Apis::MerchantapiAccountsV1beta::AccountService, decorator: Google::Apis::MerchantapiAccountsV1beta::AccountService::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
       class ListAccountsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1134,6 +1275,12 @@ module Google
         end
       end
       
+      class ProductsManagement
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class Program
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1146,6 +1293,15 @@ module Google
         end
       end
       
+      class ProposeAccountServiceRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :account_service, as: 'accountService', class: Google::Apis::MerchantapiAccountsV1beta::AccountService, decorator: Google::Apis::MerchantapiAccountsV1beta::AccountService::Representation
+      
+          property :provider, as: 'provider'
+        end
+      end
+      
       class RateGroup
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1176,6 +1332,12 @@ module Google
         end
       end
       
+      class RejectAccountServiceRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class Required
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/merchantapi_accounts_v1beta/service.rb

@@ -210,7 +210,7 @@ module Google
         # the same results as calling `ListsAccounts` with the following filter: `
         # relationship(providerId=`parent` AND service(type="ACCOUNT_AGGREGATION"))`
         # @param [String] provider
-        #   Required. The aggregation service provider. Format: `accounts/`providerId``
+        #   Required. The aggregation service provider. Format: `accounts/`accountId``
         # @param [Fixnum] page_size
         #   Optional. The maximum number of accounts to return. The service may return
         #   fewer than this value. If unspecified, at most 250 accounts are returned. The
@@ -651,10 +651,11 @@ module Google
         # merchant is exempted from claiming, which also exempts from verification) and
         # return a successful response. If ownership can no longer be verified, it will
         # return an error, but it won't clear the claim. In case of failure, a canonical
-        # error message will be returned: * PERMISSION_DENIED: user doesn't have the
-        # necessary permissions on this MC account; * FAILED_PRECONDITION: - The account
-        # is not a Merchant Center account; - MC account doesn't have a homepage; -
-        # claiming failed (in this case the error message will contain more details).
+        # error message is returned: * PERMISSION_DENIED: User doesn't have the
+        # necessary permissions on this Merchant Center account. * FAILED_PRECONDITION: -
+        # The account is not a Merchant Center account. - Merchant Center account doesn'
+        # t have a homepage. - Claiming failed (in this case the error message contains
+        # more details).
         # @param [String] name
         #   Required. The name of the homepage to claim. Format: `accounts/`account`/
         #   homepage`
@@ -1244,6 +1245,286 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Retrieve an account relationship.
+        # @param [String] name
+        #   Required. The resource name of the account relationship to get. Format: `
+        #   accounts/`account`/relationships/`relationship``
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::MerchantapiAccountsV1beta::AccountRelationship] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::MerchantapiAccountsV1beta::AccountRelationship]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_account_relationship(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'accounts/v1beta/{+name}', options)
+          command.response_representation = Google::Apis::MerchantapiAccountsV1beta::AccountRelationship::Representation
+          command.response_class = Google::Apis::MerchantapiAccountsV1beta::AccountRelationship
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # List account relationships for the specified account.
+        # @param [String] parent
+        #   Required. The parent account of the account relationship to filter by. Format:
+        #   `accounts/`account``
+        # @param [Fixnum] page_size
+        #   Optional. The maximum number of elements to return in the response. Use for
+        #   paging. If no `page_size` is specified, `100` is used as the default value.
+        #   The maximum allowed value is `1000`.
+        # @param [String] page_token
+        #   Optional. The token returned by the previous `list` request.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::MerchantapiAccountsV1beta::ListAccountRelationshipsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::MerchantapiAccountsV1beta::ListAccountRelationshipsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_account_relationships(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'accounts/v1beta/{+parent}/relationships', options)
+          command.response_representation = Google::Apis::MerchantapiAccountsV1beta::ListAccountRelationshipsResponse::Representation
+          command.response_class = Google::Apis::MerchantapiAccountsV1beta::ListAccountRelationshipsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates the account relationship. Executing this method requires admin access.
+        # @param [String] name
+        #   Identifier. The resource name of the account relationship. Format: `accounts/`
+        #   account`/relationships/`relationship``
+        # @param [Google::Apis::MerchantapiAccountsV1beta::AccountRelationship] account_relationship_object
+        # @param [String] update_mask
+        #   Optional. List of fields being updated. The following fields are supported (in
+        #   both `snake_case` and `lowerCamelCase`): - `account_id_alias`
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::MerchantapiAccountsV1beta::AccountRelationship] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::MerchantapiAccountsV1beta::AccountRelationship]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def patch_account_relationship(name, account_relationship_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'accounts/v1beta/{+name}', options)
+          command.request_representation = Google::Apis::MerchantapiAccountsV1beta::AccountRelationship::Representation
+          command.request_object = account_relationship_object
+          command.response_representation = Google::Apis::MerchantapiAccountsV1beta::AccountRelationship::Representation
+          command.response_class = Google::Apis::MerchantapiAccountsV1beta::AccountRelationship
+          command.params['name'] = name unless name.nil?
+          command.query['updateMask'] = update_mask unless update_mask.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Approve an account service proposal.
+        # @param [String] name
+        #   Required. The resource name of the account service to approve. Format: `
+        #   accounts/`account`/services/`service``
+        # @param [Google::Apis::MerchantapiAccountsV1beta::ApproveAccountServiceRequest] approve_account_service_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::MerchantapiAccountsV1beta::AccountService] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::MerchantapiAccountsV1beta::AccountService]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def approve_account_service(name, approve_account_service_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'accounts/v1beta/{+name}:approve', options)
+          command.request_representation = Google::Apis::MerchantapiAccountsV1beta::ApproveAccountServiceRequest::Representation
+          command.request_object = approve_account_service_request_object
+          command.response_representation = Google::Apis::MerchantapiAccountsV1beta::AccountService::Representation
+          command.response_class = Google::Apis::MerchantapiAccountsV1beta::AccountService
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Retrieve an account service.
+        # @param [String] name
+        #   Required. The resource name of the account service to get. Format: `accounts/`
+        #   account`/services/`service``
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::MerchantapiAccountsV1beta::AccountService] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::MerchantapiAccountsV1beta::AccountService]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_account_service(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'accounts/v1beta/{+name}', options)
+          command.response_representation = Google::Apis::MerchantapiAccountsV1beta::AccountService::Representation
+          command.response_class = Google::Apis::MerchantapiAccountsV1beta::AccountService
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # List account services for the specified accounts. Supports filtering.
+        # @param [String] parent
+        #   Required. The parent account of the account service to filter by. Format: `
+        #   accounts/`account``
+        # @param [Fixnum] page_size
+        #   Optional. The maximum number of elements to return in the response. Use for
+        #   paging. If no `page_size` is specified, `100` is used as the default value.
+        #   The maximum allowed value is `1000`.
+        # @param [String] page_token
+        #   Optional. The token returned by the previous `list` request.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::MerchantapiAccountsV1beta::ListAccountServicesResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::MerchantapiAccountsV1beta::ListAccountServicesResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_account_services(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'accounts/v1beta/{+parent}/services', options)
+          command.response_representation = Google::Apis::MerchantapiAccountsV1beta::ListAccountServicesResponse::Representation
+          command.response_class = Google::Apis::MerchantapiAccountsV1beta::ListAccountServicesResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Propose an account service.
+        # @param [String] parent
+        #   Required. The resource name of the parent account for the service. Format: `
+        #   accounts/`account``
+        # @param [Google::Apis::MerchantapiAccountsV1beta::ProposeAccountServiceRequest] propose_account_service_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::MerchantapiAccountsV1beta::AccountService] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::MerchantapiAccountsV1beta::AccountService]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def propose_account_service(parent, propose_account_service_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'accounts/v1beta/{+parent}/services:propose', options)
+          command.request_representation = Google::Apis::MerchantapiAccountsV1beta::ProposeAccountServiceRequest::Representation
+          command.request_object = propose_account_service_request_object
+          command.response_representation = Google::Apis::MerchantapiAccountsV1beta::AccountService::Representation
+          command.response_class = Google::Apis::MerchantapiAccountsV1beta::AccountService
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Reject an account service (both proposed and approve services can be rejected).
+        # @param [String] name
+        #   Required. The resource name of the account service to reject. Format: `
+        #   accounts/`account`/services/`service``
+        # @param [Google::Apis::MerchantapiAccountsV1beta::RejectAccountServiceRequest] reject_account_service_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::MerchantapiAccountsV1beta::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::MerchantapiAccountsV1beta::Empty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def reject_account_service(name, reject_account_service_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'accounts/v1beta/{+name}:reject', options)
+          command.request_representation = Google::Apis::MerchantapiAccountsV1beta::RejectAccountServiceRequest::Representation
+          command.request_object = reject_account_service_request_object
+          command.response_representation = Google::Apis::MerchantapiAccountsV1beta::Empty::Representation
+          command.response_class = Google::Apis::MerchantapiAccountsV1beta::Empty
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Retrieve shipping setting information.
         # @param [String] name
         #   Required. The name of the shipping setting to retrieve. Format: `accounts/`

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-merchantapi_accounts_v1beta
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.12.0
 platform: ruby
 authors:
 - Google LLC
 bindir: bin
 cert_chain: []
-date: 2025-04-27 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -57,7 +57,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-merchantapi_accounts_v1beta/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-merchantapi_accounts_v1beta/v0.11.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-merchantapi_accounts_v1beta/v0.12.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-merchantapi_accounts_v1beta
 rdoc_options: []
 require_paths:
@@ -66,14 +66,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.7'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.5
+rubygems_version: 3.6.8
 specification_version: 4
 summary: Simple REST client for Merchant API AccountsV1beta
 test_files: []