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

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

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

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Shopping
+    module Merchant
+      module Accounts
+        module V1
+          # Settings related to the verification email that is sent after adding a user.
+          # @!attribute [rw] verification_mail_mode
+          #   @return [::Google::Shopping::Merchant::Accounts::V1::VerificationMailSettings::VerificationMailMode]
+          #     Optional. Mode of the verification mail. If not set, the default is
+          #     `SEND_VERIFICATION_MAIL`.
+          class VerificationMailSettings
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # The different configuration options for sending a verification email
+            # when adding a user.
+            module VerificationMailMode
+              # Default first member of every enum. Do not use.
+              VERIFICATION_MAIL_MODE_UNSPECIFIED = 0
+
+              # An invitation email is sent to the user added shortly after.
+              SEND_VERIFICATION_MAIL = 1
+
+              # No invitation email is sent. This can be useful if the user is
+              # expected to accept the invitation through the API without needing
+              # another notification.
+              SUPPRESS_VERIFICATION_MAIL = 2
+            end
+          end
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-shopping-merchant-accounts-v1
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.2
 platform: ruby
 authors:
 - Google LLC
@@ -281,6 +281,7 @@ files:
 - lib/google/shopping/merchant/accounts/v1/user_service/rest/client.rb
 - lib/google/shopping/merchant/accounts/v1/user_service/rest/service_stub.rb
 - lib/google/shopping/merchant/accounts/v1/user_services_pb.rb
+- lib/google/shopping/merchant/accounts/v1/verificationmailsettings_pb.rb
 - lib/google/shopping/merchant/accounts/v1/version.rb
 - proto_docs/README.md
 - proto_docs/google/api/client.rb
@@ -317,6 +318,7 @@ files:
 - proto_docs/google/shopping/merchant/accounts/v1/termsofserviceagreementstate.rb
 - proto_docs/google/shopping/merchant/accounts/v1/termsofservicekind.rb
 - proto_docs/google/shopping/merchant/accounts/v1/user.rb
+- proto_docs/google/shopping/merchant/accounts/v1/verificationmailsettings.rb
 - proto_docs/google/shopping/type/types.rb
 - proto_docs/google/type/date.rb
 - proto_docs/google/type/datetime.rb