google-shopping-merchant-accounts-v1 0.a → 0.1.0

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

@@ -0,0 +1,118 @@
+# 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
+          # The `TermsOfService` message represents a specific version of the terms of
+          # service that merchants must accept to access certain features or services.
+          # For more information, see [Terms of
+          # Service](https://support.google.com/merchants/answer/160173).
+          #
+          # This message is important for the onboarding process, ensuring that merchants
+          # agree to the necessary legal agreements for using the service. Merchants can
+          # retrieve the latest terms of service for a given `kind` and `region` through
+          # `RetrieveLatestTermsOfService`, and accept them as required through
+          # `AcceptTermsOfService`.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Identifier. The resource name of the terms of service version.
+          #     Format: `termsOfService/{version}`
+          # @!attribute [rw] region_code
+          #   @return [::String]
+          #     Region code as defined by [CLDR](https://cldr.unicode.org/). This is either
+          #     a country where the ToS applies specifically to that country or `001` when
+          #     the same `TermsOfService` can be signed in any country. However note that
+          #     when signing a ToS that applies globally we still expect that a specific
+          #     country is provided  (this should be merchant business country or program
+          #     country of participation).
+          # @!attribute [rw] kind
+          #   @return [::Google::Shopping::Merchant::Accounts::V1::TermsOfServiceKind]
+          #     The Kind this terms of service version applies to.
+          # @!attribute [rw] file_uri
+          #   @return [::String]
+          #     URI for terms of service file that needs to be displayed to signing users.
+          # @!attribute [rw] external
+          #   @return [::Boolean]
+          #     Whether this terms of service version is external. External terms of
+          #     service versions can only be agreed through external processes and not
+          #     directly by the merchant through UI or API.
+          class TermsOfService
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for the `GetTermsOfService` method.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Required. The resource name of the terms of service version.
+          #     Format: `termsOfService/{version}`
+          class GetTermsOfServiceRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for the `RetrieveLatestTermsOfService` method.
+          # @!attribute [rw] region_code
+          #   @return [::String]
+          #     Required. Region code as defined by [CLDR](https://cldr.unicode.org/). This
+          #     is either a country when the ToS applies specifically to that country or
+          #     001 when it applies globally.
+          # @!attribute [rw] kind
+          #   @return [::Google::Shopping::Merchant::Accounts::V1::TermsOfServiceKind]
+          #     Required. The Kind this terms of service version applies to.
+          class RetrieveLatestTermsOfServiceRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for the `AcceptTermsOfService` method.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Required. The resource name of the terms of service version.
+          #     Format: `termsOfService/{version}`
+          # @!attribute [rw] account
+          #   @return [::String]
+          #     Required. The account for which to accept the ToS.
+          #     Format: `accounts/{account}`
+          # @!attribute [rw] region_code
+          #   @return [::String]
+          #     Required. Region code as defined by [CLDR](https://cldr.unicode.org/). This
+          #     is either a country when the ToS applies specifically to that country or
+          #     001 when it applies globally.
+          class AcceptTermsOfServiceRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Response message for the `AcceptTermsOfService` method.
+          # @!attribute [rw] terms_of_service_agreement_state
+          #   @return [::Google::Shopping::Merchant::Accounts::V1::TermsOfServiceAgreementState]
+          #     The agreement state after accepting the ToS.
+          class AcceptTermsOfServiceResponse
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,136 @@
+# 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
+          # This resource represents the agreement state for a given account and terms of
+          # service kind.
+          # The state is as follows:
+          #
+          # * If the business has accepted a terms of service,
+          # {::Google::Shopping::Merchant::Accounts::V1::Accepted `accepted`}
+          # will be populated, otherwise it will be empty
+          # * If the business must sign a terms of service,
+          # {::Google::Shopping::Merchant::Accounts::V1::Required `required`}
+          # will be populated, otherwise it will be empty.
+          #
+          # Note that both `required` and `accepted` can be present. In this case the
+          # `accepted` terms of services will have an expiration date set in the
+          # {::Google::Shopping::Merchant::Accounts::V1::Accepted#valid_until `valid_until`}
+          # field. The `required` terms of services need to be accepted before
+          # `valid_until` in order for the account to continue having a valid agreement.
+          # When accepting new terms of services we expect third-party providers 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
+          # {::Google::Shopping::Merchant::Accounts::V1::Required#tos_file_uri `tos_file_uri`}).
+          # The actual acceptance of the terms of service is done by calling accept on
+          # the
+          # {::Google::Shopping::Merchant::Accounts::V1::Accepted#terms_of_service `TermsOfService`}
+          # resource.
+          # `valid_until` field.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Identifier. The resource name of the terms of service version.
+          #     Format: `accounts/{account}/termsOfServiceAgreementState/{identifier}`
+          #     The identifier format is:
+          #     `{[TermsOfServiceKind][google.shopping.merchant.accounts.v1.TermsOfServiceKind]}-{country}`
+          #     For example, an identifier could be: `MERCHANT_CENTER-EU` or
+          #     `MERCHANT_CENTER-US`.
+          # @!attribute [rw] region_code
+          #   @return [::String]
+          #     Required. Region code as defined by https://cldr.unicode.org/. This is the
+          #     country the current state applies to.
+          # @!attribute [rw] terms_of_service_kind
+          #   @return [::Google::Shopping::Merchant::Accounts::V1::TermsOfServiceKind]
+          #     Required. Terms of Service kind associated with the particular version.
+          # @!attribute [rw] accepted
+          #   @return [::Google::Shopping::Merchant::Accounts::V1::Accepted]
+          #     Optional. The accepted terms of service of this kind and for the associated
+          #     region_code
+          # @!attribute [rw] required
+          #   @return [::Google::Shopping::Merchant::Accounts::V1::Required]
+          #     Optional. The required terms of service
+          class TermsOfServiceAgreementState
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Describes the [accepted terms of
+          # service](https://developers.google.com/merchant/api/guides/accounts/create-and-configure#accept_the_merchant_center_terms_of_service).
+          # @!attribute [rw] terms_of_service
+          #   @return [::String]
+          #     Required. The accepted
+          #     {::Google::Shopping::Merchant::Accounts::V1::TermsOfService termsOfService}.
+          # @!attribute [rw] accepted_by
+          #   @return [::String]
+          #     Required. The account where the acceptance was recorded. This can be the
+          #     account itself or, in the case of subaccounts, the advanced account.
+          # @!attribute [rw] valid_until
+          #   @return [::Google::Type::Date]
+          #     Optional. When set, it states that the accepted `TermsOfService` is only
+          #     valid until the end of this date (in UTC). A new one must be accepted
+          #     before then. The information of the required `TermsOfService` is found in
+          #     the `Required` message.
+          class Accepted
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Describes the terms of service which are required to be accepted.
+          # @!attribute [rw] terms_of_service
+          #   @return [::String]
+          #     Required. The `TermsOfService` that need to be accepted.
+          # @!attribute [rw] tos_file_uri
+          #   @return [::String]
+          #     Required. Full URL to the terms of service file. This field is the same as
+          #     `TermsOfService.file_uri`, it is added here for convenience only.
+          class Required
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for the `GetTermsOfServiceAgreementState` method.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Required. The resource name of the terms of service version.
+          #     Format: `accounts/{account}/termsOfServiceAgreementStates/{identifier}`
+          #     The identifier format is: `{TermsOfServiceKind}-{country}`
+          class GetTermsOfServiceAgreementStateRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for the `RetrieveForApplicationTermsOfServiceAgreementState`
+          # method.
+          # @!attribute [rw] parent
+          #   @return [::String]
+          #     Required. The account for which to get a TermsOfServiceAgreementState
+          #     Format: `accounts/{account}`
+          class RetrieveForApplicationTermsOfServiceAgreementStateRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,37 @@
+# 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
+          # The TermsOfService Kind.
+          module TermsOfServiceKind
+            # Default value. This value is unused.
+            TERMS_OF_SERVICE_KIND_UNSPECIFIED = 0
+
+            # Merchant Center application.
+            MERCHANT_CENTER = 1
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,164 @@
+# 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
+          # 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 levels](//support.google.com/merchants/answer/12160472).
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Identifier. The resource name of the user.
+          #     Format: `accounts/{account}/user/{email}`
+          #
+          #     Use `me` to refer to your own email address, for example
+          #     `accounts/{account}/users/me`.
+          # @!attribute [r] state
+          #   @return [::Google::Shopping::Merchant::Accounts::V1::User::State]
+          #     Output only. The state of the user.
+          # @!attribute [rw] access_rights
+          #   @return [::Array<::Google::Shopping::Merchant::Accounts::V1::AccessRight>]
+          #     Required. The [access
+          #     rights](https://support.google.com/merchants/answer/12160472?sjid=6789834943175119429-EU#accesstypes)
+          #     the user has.
+          class User
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # The possible states of a user.
+            module State
+              # Default value. This value is unused.
+              STATE_UNSPECIFIED = 0
+
+              # The user is pending confirmation. In this state, the user first needs to
+              # accept the invitation before performing other actions.
+              PENDING = 1
+
+              # The user is verified.
+              VERIFIED = 2
+            end
+          end
+
+          # Request message for the `GetUser` method.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Required. The name of the user to retrieve.
+          #     Format: `accounts/{account}/users/{email}`
+          #
+          #     It is also possible to retrieve the user corresponding to the caller by
+          #     using `me` rather than an email address as in
+          #     `accounts/{account}/users/me`.
+          class GetUserRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for the `CreateUser` method.
+          # @!attribute [rw] parent
+          #   @return [::String]
+          #     Required. The resource name of the account for which a user will be
+          #     created. Format: `accounts/{account}`
+          # @!attribute [rw] user_id
+          #   @return [::String]
+          #     Required. The email address of the user (for example,
+          #     `john.doe@gmail.com`).
+          # @!attribute [rw] user
+          #   @return [::Google::Shopping::Merchant::Accounts::V1::User]
+          #     Optional. The user to create.
+          class CreateUserRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for the `DeleteUser` method.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Required. The name of the user to delete.
+          #     Format: `accounts/{account}/users/{email}`
+          #
+          #     It is also possible to delete the user corresponding to the caller by using
+          #     `me` rather than an email address as in `accounts/{account}/users/me`.
+          class DeleteUserRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for the `UpdateUser` method.
+          # @!attribute [rw] user
+          #   @return [::Google::Shopping::Merchant::Accounts::V1::User]
+          #     Required. The new version of the user.
+          #
+          #     Use `me` to refer to your own email address, for example
+          #     `accounts/{account}/users/me`.
+          # @!attribute [rw] update_mask
+          #   @return [::Google::Protobuf::FieldMask]
+          #     Optional. List of fields being updated.
+          #
+          #     The following fields are supported (in both `snake_case` and
+          #     `lowerCamelCase`):
+          #
+          #     - `access_rights`
+          class UpdateUserRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for the `ListUsers` method.
+          # @!attribute [rw] parent
+          #   @return [::String]
+          #     Required. The parent, which owns this collection of users.
+          #     Format: `accounts/{account}`
+          # @!attribute [rw] page_size
+          #   @return [::Integer]
+          #     Optional. The maximum number of users to return. The service may return
+          #     fewer than this value. If unspecified, at most 50 users will be returned.
+          #     The maximum value is 100; values above 100 will be coerced to 100
+          # @!attribute [rw] page_token
+          #   @return [::String]
+          #     Optional. A page token, received from a previous `ListUsers` call.
+          #     Provide this to retrieve the subsequent page.
+          #
+          #     When paginating, all other parameters provided to `ListUsers` must match
+          #     the call that provided the page token.
+          class ListUsersRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Response message for the `ListUsers` method.
+          # @!attribute [rw] users
+          #   @return [::Array<::Google::Shopping::Merchant::Accounts::V1::User>]
+          #     The users from the specified account.
+          # @!attribute [rw] next_page_token
+          #   @return [::String]
+          #     A token, which can be sent as `page_token` to retrieve the next page.
+          #     If this field is omitted, there are no subsequent pages.
+          class ListUsersResponse
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/shopping/type/types.rb

@@ -0,0 +1,210 @@
+# 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 Type
+      # The weight represented as the value in string and the unit.
+      # @!attribute [rw] amount_micros
+      #   @return [::Integer]
+      #     Required. The weight represented as a number in micros (1 million micros is
+      #     an equivalent to one's currency standard unit, for example, 1 kg = 1000000
+      #     micros).
+      #     This field can also be set as infinity by setting to -1.
+      #     This field only support -1 and positive value.
+      # @!attribute [rw] unit
+      #   @return [::Google::Shopping::Type::Weight::WeightUnit]
+      #     Required. The weight unit.
+      #     Acceptable values are: kg and lb
+      class Weight
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+
+        # The weight unit.
+        module WeightUnit
+          # unit unspecified
+          WEIGHT_UNIT_UNSPECIFIED = 0
+
+          # lb unit.
+          POUND = 1
+
+          # kg unit.
+          KILOGRAM = 2
+        end
+      end
+
+      # The price represented as a number and currency.
+      # @!attribute [rw] amount_micros
+      #   @return [::Integer]
+      #     The price represented as a number in micros (1 million micros is an
+      #     equivalent to one's currency standard unit, for example, 1 USD = 1000000
+      #     micros).
+      # @!attribute [rw] currency_code
+      #   @return [::String]
+      #     The currency of the price using three-letter acronyms according to [ISO
+      #     4217](http://en.wikipedia.org/wiki/ISO_4217).
+      class Price
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+
+      # A message that represents custom attributes. Exactly one of `value` or
+      # `group_values` must not be empty.
+      # @!attribute [rw] name
+      #   @return [::String]
+      #     The name of the attribute.
+      # @!attribute [rw] value
+      #   @return [::String]
+      #     The value of the attribute. If `value` is not empty, `group_values` must be
+      #     empty.
+      # @!attribute [rw] group_values
+      #   @return [::Array<::Google::Shopping::Type::CustomAttribute>]
+      #     Subattributes within this attribute group.  If
+      #     `group_values` is not empty, `value` must be empty.
+      class CustomAttribute
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+
+      # Destinations available for a product.
+      #
+      # Destinations are used in Merchant Center to allow you to control where the
+      # products from your data feed should be displayed.
+      class Destination
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+
+        # Destination values.
+        module DestinationEnum
+          # Not specified.
+          DESTINATION_ENUM_UNSPECIFIED = 0
+
+          # [Shopping ads](https://support.google.com/google-ads/answer/2454022).
+          SHOPPING_ADS = 1
+
+          # [Display ads](https://support.google.com/merchants/answer/6069387).
+          DISPLAY_ADS = 2
+
+          # [Local inventory
+          # ads](https://support.google.com/merchants/answer/3057972).
+          LOCAL_INVENTORY_ADS = 3
+
+          # [Free listings](https://support.google.com/merchants/answer/9199328).
+          FREE_LISTINGS = 4
+
+          # [Free local product
+          # listings](https://support.google.com/merchants/answer/9825611).
+          FREE_LOCAL_LISTINGS = 5
+
+          # [YouTube Shopping](https://support.google.com/merchants/answer/12362804).
+          YOUTUBE_SHOPPING = 6
+        end
+      end
+
+      # Reporting contexts that your account and product issues apply to.
+      #
+      # Reporting contexts are groups of surfaces and formats for product results on
+      # Google. They can represent the entire destination (for example, [Shopping
+      # ads](https://support.google.com/merchants/answer/6149970)) or a subset of
+      # formats within a destination (for example, [Demand Gen
+      # ads](https://support.google.com/merchants/answer/13389785)).
+      class ReportingContext
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+
+        # Reporting context values.
+        module ReportingContextEnum
+          # Not specified.
+          REPORTING_CONTEXT_ENUM_UNSPECIFIED = 0
+
+          # [Shopping ads](https://support.google.com/merchants/answer/6149970).
+          SHOPPING_ADS = 1
+
+          # Deprecated:  Use `DEMAND_GEN_ADS` instead.
+          # [Discovery and Demand Gen
+          # ads](https://support.google.com/merchants/answer/13389785).
+          DISCOVERY_ADS = 2
+
+          # [Demand Gen ads](https://support.google.com/merchants/answer/13389785).
+          DEMAND_GEN_ADS = 13
+
+          # [Demand Gen ads on Discover
+          # surface](https://support.google.com/merchants/answer/13389785).
+          DEMAND_GEN_ADS_DISCOVER_SURFACE = 14
+
+          # [Video ads](https://support.google.com/google-ads/answer/6340491).
+          VIDEO_ADS = 3
+
+          # [Display ads](https://support.google.com/merchants/answer/6069387).
+          DISPLAY_ADS = 4
+
+          # [Local inventory
+          # ads](https://support.google.com/merchants/answer/3271956).
+          LOCAL_INVENTORY_ADS = 5
+
+          # [Vehicle inventory
+          # ads](https://support.google.com/merchants/answer/11544533).
+          VEHICLE_INVENTORY_ADS = 6
+
+          # [Free product
+          # listings](https://support.google.com/merchants/answer/9199328).
+          FREE_LISTINGS = 7
+
+          # [Free local product
+          # listings](https://support.google.com/merchants/answer/9825611).
+          FREE_LOCAL_LISTINGS = 8
+
+          # [Free local vehicle
+          # listings](https://support.google.com/merchants/answer/11544533).
+          FREE_LOCAL_VEHICLE_LISTINGS = 9
+
+          # [YouTube
+          # Shopping](https://support.google.com/merchants/answer/13478370).
+          YOUTUBE_SHOPPING = 10
+
+          # [Cloud retail](https://cloud.google.com/solutions/retail).
+          CLOUD_RETAIL = 11
+
+          # [Local cloud retail](https://cloud.google.com/solutions/retail).
+          LOCAL_CLOUD_RETAIL = 12
+        end
+      end
+
+      # [Channel](https://support.google.com/merchants/answer/7361332) of a product.
+      #
+      # Channel is used to distinguish between online and local products.
+      class Channel
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+
+        # Channel values.
+        module ChannelEnum
+          # Not specified.
+          CHANNEL_ENUM_UNSPECIFIED = 0
+
+          # Online product.
+          ONLINE = 1
+
+          # Local product.
+          LOCAL = 2
+        end
+      end
+    end
+  end
+end