google-shopping-merchant-accounts-v1 0.3.1 → 0.3.2

data/lib/google/shopping/merchant/accounts/v1/user_service/client.rb

@@ -661,6 +661,93 @@ module Google
                 raise ::Google::Cloud::Error.from_error(e)
               end
 
+              ##
+              # Updates the user that is represented by the caller from pending to
+              # verified.
+              #
+              # @overload verify_self(request, options = nil)
+              #   Pass arguments to `verify_self` via a request object, either of type
+              #   {::Google::Shopping::Merchant::Accounts::V1::VerifySelfRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Shopping::Merchant::Accounts::V1::VerifySelfRequest, ::Hash]
+              #     A request object representing the call parameters. Required. To specify no
+              #     parameters, or to keep all the default parameter values, pass an empty Hash.
+              #   @param options [::Gapic::CallOptions, ::Hash]
+              #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+              #
+              # @overload verify_self(account: nil)
+              #   Pass arguments to `verify_self` via keyword arguments. Note that at
+              #   least one keyword argument is required. To specify no parameters, or to keep all
+              #   the default parameter values, pass an empty Hash as a request object (see above).
+              #
+              #   @param account [::String]
+              #     Required. The name of the account under which the caller is a user.
+              #     Format: `accounts/{account}`
+              #
+              # @yield [response, operation] Access the result along with the RPC operation
+              # @yieldparam response [::Google::Shopping::Merchant::Accounts::V1::User]
+              # @yieldparam operation [::GRPC::ActiveCall::Operation]
+              #
+              # @return [::Google::Shopping::Merchant::Accounts::V1::User]
+              #
+              # @raise [::Google::Cloud::Error] if the RPC is aborted.
+              #
+              # @example Basic example
+              #   require "google/shopping/merchant/accounts/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Shopping::Merchant::Accounts::V1::UserService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Shopping::Merchant::Accounts::V1::VerifySelfRequest.new
+              #
+              #   # Call the verify_self method.
+              #   result = client.verify_self request
+              #
+              #   # The returned object is of type Google::Shopping::Merchant::Accounts::V1::User.
+              #   p result
+              #
+              def verify_self request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Shopping::Merchant::Accounts::V1::VerifySelfRequest
+
+                # Converts hash and nil to an options object
+                options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                # Customize the options with defaults
+                metadata = @config.rpcs.verify_self.metadata.to_h
+
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+                metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                  lib_name: @config.lib_name, lib_version: @config.lib_version,
+                  gapic_version: ::Google::Shopping::Merchant::Accounts::V1::VERSION
+                metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+                metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                header_params = {}
+                if request.account
+                  header_params["account"] = request.account
+                end
+
+                request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+                metadata[:"x-goog-request-params"] ||= request_params_header
+
+                options.apply_defaults timeout:      @config.rpcs.verify_self.timeout,
+                                       metadata:     metadata,
+                                       retry_policy: @config.rpcs.verify_self.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @user_service_stub.call_rpc :verify_self, request, options: options do |response, operation|
+                  yield response, operation if block_given?
+                end
+              rescue ::GRPC::BadStatus => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
               ##
               # Configuration class for the UserService API.
               #
@@ -869,6 +956,11 @@ module Google
                   # @return [::Gapic::Config::Method]
                   #
                   attr_reader :list_users
+                  ##
+                  # RPC-specific configuration for `verify_self`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :verify_self
 
                   # @private
                   def initialize parent_rpcs = nil
@@ -882,6 +974,8 @@ module Google
                     @update_user = ::Gapic::Config::Method.new update_user_config
                     list_users_config = parent_rpcs.list_users if parent_rpcs.respond_to? :list_users
                     @list_users = ::Gapic::Config::Method.new list_users_config
+                    verify_self_config = parent_rpcs.verify_self if parent_rpcs.respond_to? :verify_self
+                    @verify_self = ::Gapic::Config::Method.new verify_self_config
 
                     yield self if block_given?
                   end

data/lib/google/shopping/merchant/accounts/v1/user_service/rest/client.rb

@@ -619,6 +619,86 @@ module Google
                   raise ::Google::Cloud::Error.from_error(e)
                 end
 
+                ##
+                # Updates the user that is represented by the caller from pending to
+                # verified.
+                #
+                # @overload verify_self(request, options = nil)
+                #   Pass arguments to `verify_self` via a request object, either of type
+                #   {::Google::Shopping::Merchant::Accounts::V1::VerifySelfRequest} or an equivalent Hash.
+                #
+                #   @param request [::Google::Shopping::Merchant::Accounts::V1::VerifySelfRequest, ::Hash]
+                #     A request object representing the call parameters. Required. To specify no
+                #     parameters, or to keep all the default parameter values, pass an empty Hash.
+                #   @param options [::Gapic::CallOptions, ::Hash]
+                #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+                #
+                # @overload verify_self(account: nil)
+                #   Pass arguments to `verify_self` via keyword arguments. Note that at
+                #   least one keyword argument is required. To specify no parameters, or to keep all
+                #   the default parameter values, pass an empty Hash as a request object (see above).
+                #
+                #   @param account [::String]
+                #     Required. The name of the account under which the caller is a user.
+                #     Format: `accounts/{account}`
+                # @yield [result, operation] Access the result along with the TransportOperation object
+                # @yieldparam result [::Google::Shopping::Merchant::Accounts::V1::User]
+                # @yieldparam operation [::Gapic::Rest::TransportOperation]
+                #
+                # @return [::Google::Shopping::Merchant::Accounts::V1::User]
+                #
+                # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/shopping/merchant/accounts/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Shopping::Merchant::Accounts::V1::UserService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Shopping::Merchant::Accounts::V1::VerifySelfRequest.new
+                #
+                #   # Call the verify_self method.
+                #   result = client.verify_self request
+                #
+                #   # The returned object is of type Google::Shopping::Merchant::Accounts::V1::User.
+                #   p result
+                #
+                def verify_self request, options = nil
+                  raise ::ArgumentError, "request must be provided" if request.nil?
+
+                  request = ::Gapic::Protobuf.coerce request, to: ::Google::Shopping::Merchant::Accounts::V1::VerifySelfRequest
+
+                  # Converts hash and nil to an options object
+                  options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                  # Customize the options with defaults
+                  call_metadata = @config.rpcs.verify_self.metadata.to_h
+
+                  # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+                  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                    lib_name: @config.lib_name, lib_version: @config.lib_version,
+                    gapic_version: ::Google::Shopping::Merchant::Accounts::V1::VERSION,
+                    transports_version_send: [:rest]
+
+                  call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+                  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                  options.apply_defaults timeout:      @config.rpcs.verify_self.timeout,
+                                         metadata:     call_metadata,
+                                         retry_policy: @config.rpcs.verify_self.retry_policy
+
+                  options.apply_defaults timeout:      @config.timeout,
+                                         metadata:     @config.metadata,
+                                         retry_policy: @config.retry_policy
+
+                  @user_service_stub.verify_self request, options do |result, operation|
+                    yield result, operation if block_given?
+                  end
+                rescue ::Gapic::Rest::Error => e
+                  raise ::Google::Cloud::Error.from_error(e)
+                end
+
                 ##
                 # Configuration class for the UserService REST API.
                 #
@@ -790,6 +870,11 @@ module Google
                     # @return [::Gapic::Config::Method]
                     #
                     attr_reader :list_users
+                    ##
+                    # RPC-specific configuration for `verify_self`
+                    # @return [::Gapic::Config::Method]
+                    #
+                    attr_reader :verify_self
 
                     # @private
                     def initialize parent_rpcs = nil
@@ -803,6 +888,8 @@ module Google
                       @update_user = ::Gapic::Config::Method.new update_user_config
                       list_users_config = parent_rpcs.list_users if parent_rpcs.respond_to? :list_users
                       @list_users = ::Gapic::Config::Method.new list_users_config
+                      verify_self_config = parent_rpcs.verify_self if parent_rpcs.respond_to? :verify_self
+                      @verify_self = ::Gapic::Config::Method.new verify_self_config
 
                       yield self if block_given?
                     end

data/lib/google/shopping/merchant/accounts/v1/user_service/rest/service_stub.rb

@@ -274,6 +274,46 @@ module Google
                   end
                 end
 
+                ##
+                # Baseline implementation for the verify_self REST call
+                #
+                # @param request_pb [::Google::Shopping::Merchant::Accounts::V1::VerifySelfRequest]
+                #   A request object representing the call parameters. Required.
+                # @param options [::Gapic::CallOptions]
+                #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+                #
+                # @yield [result, operation] Access the result along with the TransportOperation object
+                # @yieldparam result [::Google::Shopping::Merchant::Accounts::V1::User]
+                # @yieldparam operation [::Gapic::Rest::TransportOperation]
+                #
+                # @return [::Google::Shopping::Merchant::Accounts::V1::User]
+                #   A result object deserialized from the server's reply
+                def verify_self request_pb, options = nil
+                  raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+                  verb, uri, query_string_params, body = ServiceStub.transcode_verify_self_request request_pb
+                  query_string_params = if query_string_params.any?
+                                          query_string_params.to_h { |p| p.split "=", 2 }
+                                        else
+                                          {}
+                                        end
+
+                  response = @client_stub.make_http_request(
+                    verb,
+                    uri: uri,
+                    body: body || "",
+                    params: query_string_params,
+                    method_name: "verify_self",
+                    options: options
+                  )
+                  operation = ::Gapic::Rest::TransportOperation.new response
+                  result = ::Google::Shopping::Merchant::Accounts::V1::User.decode_json response.body, ignore_unknown_fields: true
+                  catch :response do
+                    yield result, operation if block_given?
+                    result
+                  end
+                end
+
                 ##
                 # @private
                 #
@@ -380,6 +420,28 @@ module Google
                                                           )
                   transcoder.transcode request_pb
                 end
+
+                ##
+                # @private
+                #
+                # GRPC transcoding helper method for the verify_self REST call
+                #
+                # @param request_pb [::Google::Shopping::Merchant::Accounts::V1::VerifySelfRequest]
+                #   A request object representing the call parameters. Required.
+                # @return [Array(String, [String, nil], Hash{String => String})]
+                #   Uri, Body, Query string parameters
+                def self.transcode_verify_self_request request_pb
+                  transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                          .with_bindings(
+                                                            uri_method: :patch,
+                                                            uri_template: "/accounts/v1/{account}/users/me:verifySelf",
+                                                            body: "*",
+                                                            matches: [
+                                                              ["account", %r{^accounts/[^/]+/?$}, false]
+                                                            ]
+                                                          )
+                  transcoder.transcode request_pb
+                end
               end
             end
           end

data/lib/google/shopping/merchant/accounts/v1/user_services_pb.rb

@@ -49,6 +49,9 @@ module Google
               rpc :UpdateUser, ::Google::Shopping::Merchant::Accounts::V1::UpdateUserRequest, ::Google::Shopping::Merchant::Accounts::V1::User
               # Lists all users of a Merchant Center account.
               rpc :ListUsers, ::Google::Shopping::Merchant::Accounts::V1::ListUsersRequest, ::Google::Shopping::Merchant::Accounts::V1::ListUsersResponse
+              # Updates the user that is represented by the caller from pending to
+              # verified.
+              rpc :VerifySelf, ::Google::Shopping::Merchant::Accounts::V1::VerifySelfRequest, ::Google::Shopping::Merchant::Accounts::V1::User
             end
 
             Stub = Service.rpc_stub_class

data/lib/google/shopping/merchant/accounts/v1/verificationmailsettings_pb.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/shopping/merchant/accounts/v1/verificationmailsettings.proto
+
+require 'google/protobuf'
+
+require 'google/api/field_behavior_pb'
+
+
+descriptor_data = "\nCgoogle/shopping/merchant/accounts/v1/verificationmailsettings.proto\x12$google.shopping.merchant.accounts.v1\x1a\x1fgoogle/api/field_behavior.proto\"\x90\x02\n\x18VerificationMailSettings\x12x\n\x16verification_mail_mode\x18\x01 \x01(\x0e\x32S.google.shopping.merchant.accounts.v1.VerificationMailSettings.VerificationMailModeB\x03\xe0\x41\x01\"z\n\x14VerificationMailMode\x12&\n\"VERIFICATION_MAIL_MODE_UNSPECIFIED\x10\x00\x12\x1a\n\x16SEND_VERIFICATION_MAIL\x10\x01\x12\x1e\n\x1aSUPPRESS_VERIFICATION_MAIL\x10\x02\x42\x90\x02\n(com.google.shopping.merchant.accounts.v1B\x1dVerificationMailSettingsProtoP\x01ZJcloud.google.com/go/shopping/merchant/accounts/apiv1/accountspb;accountspb\xaa\x02$Google.Shopping.Merchant.Accounts.V1\xca\x02$Google\\Shopping\\Merchant\\Accounts\\V1\xea\x02(Google::Shopping::Merchant::Accounts::V1b\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
+  end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
+end
+
+module Google
+  module Shopping
+    module Merchant
+      module Accounts
+        module V1
+          VerificationMailSettings = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.shopping.merchant.accounts.v1.VerificationMailSettings").msgclass
+          VerificationMailSettings::VerificationMailMode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.shopping.merchant.accounts.v1.VerificationMailSettings.VerificationMailMode").enummodule
+        end
+      end
+    end
+  end
+end

data/lib/google/shopping/merchant/accounts/v1/version.rb

@@ -22,7 +22,7 @@ module Google
     module Merchant
       module Accounts
         module V1
-          VERSION = "0.3.1"
+          VERSION = "0.3.2"
         end
       end
     end

data/proto_docs/google/shopping/merchant/accounts/v1/accessright.rb

@@ -22,7 +22,8 @@ module Google
     module Merchant
       module Accounts
         module V1
-          # The access right.
+          # The access right defines the level of permission a
+          # user has within a Merchant Center account.
           module AccessRight
             # Default value. This value is unused.
             ACCESS_RIGHT_UNSPECIFIED = 0
@@ -41,7 +42,8 @@ module Google
             PERFORMANCE_REPORTING = 3
 
             # Users with this right have access to Merchant API and its notifications.
-            # This role is only accessible to accounts that has a developer registration.
+            # This role is only accessible to accounts that have a developer
+            # registration.
             API_DEVELOPER = 5
           end
         end

data/proto_docs/google/shopping/merchant/accounts/v1/accounts.rb

@@ -101,6 +101,11 @@ module Google
           #     used to create a sub-account under an existing advanced account through
           #     this method. Additional `account_management` or
           #     `product_management` services may be provided.
+          # @!attribute [rw] set_alias
+          #   @return [::Array<::Google::Shopping::Merchant::Accounts::V1::CreateAndConfigureAccountRequest::SetAliasForRelationship>]
+          #     Optional. If a relationship is created with a provider, you can set an
+          #     alias for it with this field. The calling user must be an admin on the
+          #     provider to be able to set an alias.
           class CreateAndConfigureAccountRequest
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -114,6 +119,10 @@ module Google
             #   @return [::Google::Shopping::Merchant::Accounts::V1::User]
             #     Optional. Details about the user to be added. At the moment, only access
             #     rights may be specified.
+            # @!attribute [rw] verification_mail_settings
+            #   @return [::Google::Shopping::Merchant::Accounts::V1::VerificationMailSettings]
+            #     Optional. Settings related to configuring the verification email that is
+            #     sent after adding a user.
             class AddUser
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -126,15 +135,78 @@ module Google
             #     The provider is an
             #     [aggregator](https://support.google.com/merchants/answer/188487) for
             #     the account. Payload for service type Account Aggregation.
+            #
+            #     Note: The following fields are mutually exclusive: `account_aggregation`, `account_management`, `comparison_shopping`, `products_management`, `campaigns_management`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            # @!attribute [rw] account_management
+            #   @return [::Google::Shopping::Merchant::Accounts::V1::AccountManagement]
+            #     The provider manages this account. Payload for service type Account
+            #     Management.
+            #
+            #     Note: The following fields are mutually exclusive: `account_management`, `account_aggregation`, `comparison_shopping`, `products_management`, `campaigns_management`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            # @!attribute [rw] comparison_shopping
+            #   @return [::Google::Shopping::Merchant::Accounts::V1::ComparisonShopping]
+            #     The provider is a CSS (Comparison Shopping Service) of this account.
+            #     Payload for service type Comparison Shopping.
+            #
+            #     Note: The following fields are mutually exclusive: `comparison_shopping`, `account_aggregation`, `account_management`, `products_management`, `campaigns_management`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            # @!attribute [rw] products_management
+            #   @return [::Google::Shopping::Merchant::Accounts::V1::ProductsManagement]
+            #     The provider manages products for this account. Payload for service
+            #     type products management.
+            #
+            #     Note: The following fields are mutually exclusive: `products_management`, `account_aggregation`, `account_management`, `comparison_shopping`, `campaigns_management`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+            # @!attribute [rw] campaigns_management
+            #   @return [::Google::Shopping::Merchant::Accounts::V1::CampaignsManagement]
+            #     The provider manages campaigns for this account. Payload for service
+            #     type campaigns management.
+            #
+            #     Note: The following fields are mutually exclusive: `campaigns_management`, `account_aggregation`, `account_management`, `comparison_shopping`, `products_management`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             # @!attribute [rw] provider
             #   @return [::String]
             #     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`).
+            # @!attribute [rw] external_account_id
+            #   @return [::String]
+            #     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.
+            #
+            #     The external account ID must be specified for the campaigns management
+            #     service type.
+            #
+            #     The external account ID must not be specified for the account aggregation
+            #     service type.
+            #
+            #     The external account ID is optional / may be specified for all other
+            #     service types.
             class AddAccountService
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
             end
+
+            # Set an alias for a relationship between a provider and the account to
+            # be created.
+            # @!attribute [rw] provider
+            #   @return [::String]
+            #     Required. The provider of the service. This is a reference to an account
+            #     such as `providers/123` or `accounts/123`. The same provider must be
+            #     specified in at least one of the `service` fields.
+            # @!attribute [rw] account_id_alias
+            #   @return [::String]
+            #     Required. The unique ID of this account in the provider's system.
+            #     The value must be unique across all accounts on the platform for this
+            #     provider.
+            class SetAliasForRelationship
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
           end
 
           # Request message for the `DeleteAccount` method.

data/proto_docs/google/shopping/merchant/accounts/v1/accountservices.rb

@@ -48,14 +48,14 @@ module Google
           #     management or catalog synchronization services to keep the business's
           #     product information up-to-date across platforms.
           #
-          #     Note: The following fields are mutually exclusive: `products_management`, `campaigns_management`, `account_management`, `account_aggregation`, `local_listing_management`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          #     Note: The following fields are mutually exclusive: `products_management`, `campaigns_management`, `account_management`, `account_aggregation`, `local_listing_management`, `comparison_shopping`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] campaigns_management
           #   @return [::Google::Shopping::Merchant::Accounts::V1::CampaignsManagement]
           #     Service type for managing advertising campaigns. Grants the provider
           #     access to create and manage the business's ad campaigns, including
           #     setting up campaigns, adjusting bids, and optimizing performance.
           #
-          #     Note: The following fields are mutually exclusive: `campaigns_management`, `products_management`, `account_management`, `account_aggregation`, `local_listing_management`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          #     Note: The following fields are mutually exclusive: `campaigns_management`, `products_management`, `account_management`, `account_aggregation`, `local_listing_management`, `comparison_shopping`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] account_management
           #   @return [::Google::Shopping::Merchant::Accounts::V1::AccountManagement]
           #     Service type for account management. Enables the provider to perform
@@ -63,7 +63,7 @@ module Google
           #     configuring account settings, managing users, or updating business
           #     information.
           #
-          #     Note: The following fields are mutually exclusive: `account_management`, `products_management`, `campaigns_management`, `account_aggregation`, `local_listing_management`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          #     Note: The following fields are mutually exclusive: `account_management`, `products_management`, `campaigns_management`, `account_aggregation`, `local_listing_management`, `comparison_shopping`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] account_aggregation
           #   @return [::Google::Shopping::Merchant::Accounts::V1::AccountAggregation]
           #     Service type for account aggregation. This enables the provider, which is
@@ -75,14 +75,21 @@ module Google
           #     This is useful for agencies, aggregators, or large retailers that need
           #     centralized control over many Merchant Center accounts.
           #
-          #     Note: The following fields are mutually exclusive: `account_aggregation`, `products_management`, `campaigns_management`, `account_management`, `local_listing_management`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          #     Note: The following fields are mutually exclusive: `account_aggregation`, `products_management`, `campaigns_management`, `account_management`, `local_listing_management`, `comparison_shopping`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] local_listing_management
           #   @return [::Google::Shopping::Merchant::Accounts::V1::LocalListingManagement]
           #     Service type for local listings management. The business group associated
           #     with the external account id will be used to provide local inventory to
           #     this Merchant Center account.
           #
-          #     Note: The following fields are mutually exclusive: `local_listing_management`, `products_management`, `campaigns_management`, `account_management`, `account_aggregation`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          #     Note: The following fields are mutually exclusive: `local_listing_management`, `products_management`, `campaigns_management`, `account_management`, `account_aggregation`, `comparison_shopping`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] comparison_shopping
+          #   @return [::Google::Shopping::Merchant::Accounts::V1::ComparisonShopping]
+          #     Service type for comparison shopping. The provider is a CSS (Comparison
+          #     Shopping Service) managing the account. See
+          #     https://support.google.com/merchants/answer/12653197
+          #
+          #     Note: The following fields are mutually exclusive: `comparison_shopping`, `products_management`, `campaigns_management`, `account_management`, `account_aggregation`, `local_listing_management`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] name
           #   @return [::String]
           #     Identifier. The resource name of the account service.
@@ -241,6 +248,12 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # `ComparisonShopping` payload.
+          class ComparisonShopping
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # The current status of establishing of the service.
           # (for example, pending approval or approved).
           # @!attribute [r] approval_state

data/proto_docs/google/shopping/merchant/accounts/v1/developerregistration.rb

@@ -50,7 +50,9 @@ module Google
           #     updated to have the new "API notifications" preference. If the developer
           #     email provided is not associated with any user we will just add it as a
           #     contact. The email preference corresponding to that contact will have the
-          #     new "API notifications" preference
+          #     new "API notifications" preference. Make sure the email used is associated
+          #     with a Google Account (Google Workspace account or Gmail account)
+          #     and is not a service account as service accounts can't receive emails.
           class RegisterGcpRequest
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -75,6 +77,15 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
+
+          # Response message for the GetAccountForGcpRegistration method.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     The name of the merchant account id that the GCP is registered with.
+          class GetAccountForGcpRegistrationResponse
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
         end
       end
     end

data/proto_docs/google/shopping/merchant/accounts/v1/programs.rb

@@ -33,6 +33,7 @@ module Google
           # The following list is the available set of program resource IDs accessible
           # through the API:
           #
+          # * `checkout`
           # * `free-listings`
           # * `shopping-ads`
           # * `youtube-shopping-checkout`

data/proto_docs/google/shopping/merchant/accounts/v1/user.rb

@@ -22,7 +22,7 @@ module Google
     module Merchant
       module Accounts
         module V1
-          # The `User` message represents a user associated with a Merchant Center
+          # The `User` resource represents a user associated with a Merchant Center
           # account. It is used to manage user permissions and access rights within the
           # account. For more information, see [Frequently asked questions about people
           # and access levels](//support.google.com/merchants/answer/12160472).
@@ -45,7 +45,9 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
 
-            # The possible states of a user.
+            # The state represents the possible statuses of a user. It is an output-only
+            # field that is set to `PENDING` when a user is invited to an account and
+            # changes to `VERIFIED` once the user accepts the invitation.
             module State
               # Default value. This value is unused.
               STATE_UNSPECIFIED = 0
@@ -157,6 +159,16 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
+
+          # Request message for the `VerifySelf` method.
+          # @!attribute [rw] account
+          #   @return [::String]
+          #     Required. The name of the account under which the caller is a user.
+          #     Format: `accounts/{account}`
+          class VerifySelfRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
         end
       end
     end