google-apis-merchantapi_accounts_v1beta 0.16.0 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cb4ab3616df3e97f8bc39ed0bf54896972b8d578aca21d935469190b2b27dfe9
-  data.tar.gz: e49f7d1de7279958007e0b86cd83b81ddba31e921554ccf0cf5d7d3a3ed9622c
+  metadata.gz: 85ed895c20124b840e23e363906b043bfbbe02260ac4826dd257651ed2390d67
+  data.tar.gz: 6d2f63f30a5bd92b1311f7da13e3f4bbf6c81750cd690b02ce0e12ff61ab3739
 SHA512:
-  metadata.gz: c23a0e104d69d1b3f817a0e6cd57a66389079ca50cc12bffb21fc8acec1ac7733b89de1eca1f213ea1d84ba8b4338867a48027913460194edeadc91069d7d2d4
-  data.tar.gz: 6bbb2a3075dc903216faf9c233019712417314158939aeb323eced1fbce0630ef3284e58e5674f5b23653721cb40085278bd3ebc0b3a5fc152389d260d44f9dd
+  metadata.gz: aa49005b03477e0375c0c6fe67d06c4de58a0b5853e03f4c4d0861c00e998cb811614dcbb6fd360c909d3bc1e5d82b98cb1d1f972e2c601fdf5986d7ea847f3a
+  data.tar.gz: b12de1bbb6d3da47b8891a6cbe33ba46d1caeb181c1be6c17fd9799332715b11dda09b06da04a5de484f95099174a5435876df375956af84dad9474c6e930584

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-merchantapi_accounts_v1beta
 
+### v0.17.0 (2025-07-06)
+
+* Regenerated from discovery document revision 20250628
+
 ### v0.16.0 (2025-06-29)
 
 * Regenerated from discovery document revision 20250621

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

@@ -990,6 +990,81 @@ module Google
         end
       end
       
+      # [CheckoutSettings](https://support.google.com/merchants/answer/13945960) for a
+      # specific merchant.
+      class CheckoutSettings
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The effective value of enrollment_state for a given merchant ID.
+        # If account level settings are present then this value will be a copy of the
+        # account level settings. Otherwise, it will have the value of the parent
+        # account (for only marketplace sellers).
+        # Corresponds to the JSON property `effectiveEnrollmentState`
+        # @return [String]
+        attr_accessor :effective_enrollment_state
+      
+        # Output only. The effective value of `review_state` for a given merchant ID. If
+        # account level settings are present then this value will be a copy of the
+        # account level settings. Otherwise, it will have the value of the parent
+        # account (for only marketplace sellers).
+        # Corresponds to the JSON property `effectiveReviewState`
+        # @return [String]
+        attr_accessor :effective_review_state
+      
+        # URL settings for cart or checkout URL.
+        # Corresponds to the JSON property `effectiveUriSettings`
+        # @return [Google::Apis::MerchantapiAccountsV1beta::UriSettings]
+        attr_accessor :effective_uri_settings
+      
+        # Optional. The destinations to which the checkout program applies, valid
+        # destination values are `SHOPPING_ADS`, `FREE_LISTINGS`
+        # Corresponds to the JSON property `eligibleDestinations`
+        # @return [Array<String>]
+        attr_accessor :eligible_destinations
+      
+        # Output only. Reflects the merchant enrollment state in `Checkout` program.
+        # Corresponds to the JSON property `enrollmentState`
+        # @return [String]
+        attr_accessor :enrollment_state
+      
+        # Identifier. The resource name of the program configuration settings. Format: `
+        # accounts/`account`/programs/`program`/checkoutSettings`
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Output only. Reflects the merchant review state in `Checkout` program. This is
+        # set based on the data quality reviews of the URL provided by the merchant. A
+        # merchant with enrollment state as `ENROLLED` can be in the following review
+        # states: `IN_REVIEW`, `APPROVED` or `DISAPPROVED`. A merchant must be in an `
+        # enrollment_state` of `ENROLLED` before a review can begin for the merchant.For
+        # more details, check the help center doc.
+        # Corresponds to the JSON property `reviewState`
+        # @return [String]
+        attr_accessor :review_state
+      
+        # URL settings for cart or checkout URL.
+        # Corresponds to the JSON property `uriSettings`
+        # @return [Google::Apis::MerchantapiAccountsV1beta::UriSettings]
+        attr_accessor :uri_settings
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @effective_enrollment_state = args[:effective_enrollment_state] if args.key?(:effective_enrollment_state)
+          @effective_review_state = args[:effective_review_state] if args.key?(:effective_review_state)
+          @effective_uri_settings = args[:effective_uri_settings] if args.key?(:effective_uri_settings)
+          @eligible_destinations = args[:eligible_destinations] if args.key?(:eligible_destinations)
+          @enrollment_state = args[:enrollment_state] if args.key?(:enrollment_state)
+          @name = args[:name] if args.key?(:name)
+          @review_state = args[:review_state] if args.key?(:review_state)
+          @uri_settings = args[:uri_settings] if args.key?(:uri_settings)
+        end
+      end
+      
       # Request message for the `ClaimHomepage` method.
       class ClaimHomepageRequest
         include Google::Apis::Core::Hashable
@@ -4116,6 +4191,39 @@ module Google
         end
       end
       
+      # URL settings for cart or checkout URL.
+      class UriSettings
+        include Google::Apis::Core::Hashable
+      
+        # Cart URL template. When the placeholders are expanded will redirect the buyer
+        # to the cart page on the merchant website with the selected item in cart. For
+        # more details, check the [help center doc](https://support.google.com/merchants/
+        # answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-
+        # url-formatting)
+        # Corresponds to the JSON property `cartUriTemplate`
+        # @return [String]
+        attr_accessor :cart_uri_template
+      
+        # Checkout URL template. When the placeholders are expanded will redirect the
+        # buyer to the merchant checkout page with the item in the cart. For more
+        # details, check the [help center doc](https://support.google.com/merchants/
+        # answer/13945960#method1&zippy=%2Cproduct-level-url-formatting%2Caccount-level-
+        # url-formatting)
+        # Corresponds to the JSON property `checkoutUriTemplate`
+        # @return [String]
+        attr_accessor :checkout_uri_template
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @cart_uri_template = args[:cart_uri_template] if args.key?(:cart_uri_template)
+          @checkout_uri_template = args[:checkout_uri_template] if args.key?(:checkout_uri_template)
+        end
+      end
+      
       # The `User` message represents a user associated with a Merchant Center account.
       # It is used to manage user permissions and access rights within the account.
       # For more information, see [Frequently asked questions about people and access

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.16.0"
+      GEM_VERSION = "0.17.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.18.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20250621"
+      REVISION = "20250628"
     end
   end
 end

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

@@ -160,6 +160,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class CheckoutSettings
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ClaimHomepageRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -688,6 +694,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class UriSettings
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class User
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -966,6 +978,22 @@ module Google
         end
       end
       
+      class CheckoutSettings
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :effective_enrollment_state, as: 'effectiveEnrollmentState'
+          property :effective_review_state, as: 'effectiveReviewState'
+          property :effective_uri_settings, as: 'effectiveUriSettings', class: Google::Apis::MerchantapiAccountsV1beta::UriSettings, decorator: Google::Apis::MerchantapiAccountsV1beta::UriSettings::Representation
+      
+          collection :eligible_destinations, as: 'eligibleDestinations'
+          property :enrollment_state, as: 'enrollmentState'
+          property :name, as: 'name'
+          property :review_state, as: 'reviewState'
+          property :uri_settings, as: 'uriSettings', class: Google::Apis::MerchantapiAccountsV1beta::UriSettings, decorator: Google::Apis::MerchantapiAccountsV1beta::UriSettings::Representation
+      
+        end
+      end
+      
       class ClaimHomepageRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1821,6 +1849,14 @@ module Google
         end
       end
       
+      class UriSettings
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :cart_uri_template, as: 'cartUriTemplate'
+          property :checkout_uri_template, as: 'checkoutUriTemplate'
+        end
+      end
+      
       class User
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -1510,6 +1510,142 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates `CheckoutSettings` for the given merchant.
+        # @param [String] parent
+        #   Required. The merchant account for which the `CheckoutSettings` will be
+        #   created.
+        # @param [Google::Apis::MerchantapiAccountsV1beta::CheckoutSettings] checkout_settings_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::CheckoutSettings] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::MerchantapiAccountsV1beta::CheckoutSettings]
+        #
+        # @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 create_account_program_checkout_setting(parent, checkout_settings_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'accounts/v1beta/{+parent}/checkoutSettings', options)
+          command.request_representation = Google::Apis::MerchantapiAccountsV1beta::CheckoutSettings::Representation
+          command.request_object = checkout_settings_object
+          command.response_representation = Google::Apis::MerchantapiAccountsV1beta::CheckoutSettings::Representation
+          command.response_class = Google::Apis::MerchantapiAccountsV1beta::CheckoutSettings
+          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
+        
+        # Deletes `CheckoutSettings` and unenrolls merchant from `Checkout` program.
+        # @param [String] name
+        #   Required. The name/identifier of the merchant account. Format: `accounts/`
+        #   account`/programs/`program`/checkoutSettings`
+        # @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 delete_account_program_checkout_setting_checkout_settings(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'accounts/v1beta/{+name}', options)
+          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
+        
+        # Gets `CheckoutSettings` for the given merchant. This includes information
+        # about review state, enrollment state and URL settings.
+        # @param [String] name
+        #   Required. The name/identifier of the merchant account. Format: `accounts/`
+        #   account`/programs/`program`/checkoutSettings`
+        # @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::CheckoutSettings] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::MerchantapiAccountsV1beta::CheckoutSettings]
+        #
+        # @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_program_checkout_setting_checkout_settings(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'accounts/v1beta/{+name}', options)
+          command.response_representation = Google::Apis::MerchantapiAccountsV1beta::CheckoutSettings::Representation
+          command.response_class = Google::Apis::MerchantapiAccountsV1beta::CheckoutSettings
+          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
+        
+        # Updates `CheckoutSettings` for the given merchant.
+        # @param [String] name
+        #   Identifier. The resource name of the program configuration settings. Format: `
+        #   accounts/`account`/programs/`program`/checkoutSettings`
+        # @param [Google::Apis::MerchantapiAccountsV1beta::CheckoutSettings] checkout_settings_object
+        # @param [String] update_mask
+        #   Required. List of fields being updated. The following fields are supported (in
+        #   both `snake_case` and `lowerCamelCase`): - `eligible_destinations` - `
+        #   uri_settings`
+        # @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::CheckoutSettings] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::MerchantapiAccountsV1beta::CheckoutSettings]
+        #
+        # @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 update_account_program_checkout_setting_checkout_settings(name, checkout_settings_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::CheckoutSettings::Representation
+          command.request_object = checkout_settings_object
+          command.response_representation = Google::Apis::MerchantapiAccountsV1beta::CheckoutSettings::Representation
+          command.response_class = Google::Apis::MerchantapiAccountsV1beta::CheckoutSettings
+          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
+        
         # Creates a region definition in your Merchant Center account. Executing this
         # method requires admin access.
         # @param [String] parent

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-merchantapi_accounts_v1beta
 version: !ruby/object:Gem::Version
-  version: 0.16.0
+  version: 0.17.0
 platform: ruby
 authors:
 - Google LLC
@@ -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.16.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-merchantapi_accounts_v1beta/v0.17.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-merchantapi_accounts_v1beta
 rdoc_options: []
 require_paths: