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

data/proto_docs/google/protobuf/timestamp.rb

@@ -0,0 +1,127 @@
+# 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 Protobuf
+    # A Timestamp represents a point in time independent of any time zone or local
+    # calendar, encoded as a count of seconds and fractions of seconds at
+    # nanosecond resolution. The count is relative to an epoch at UTC midnight on
+    # January 1, 1970, in the proleptic Gregorian calendar which extends the
+    # Gregorian calendar backwards to year one.
+    #
+    # All minutes are 60 seconds long. Leap seconds are "smeared" so that no leap
+    # second table is needed for interpretation, using a [24-hour linear
+    # smear](https://developers.google.com/time/smear).
+    #
+    # The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By
+    # restricting to that range, we ensure that we can convert to and from [RFC
+    # 3339](https://www.ietf.org/rfc/rfc3339.txt) date strings.
+    #
+    # # Examples
+    #
+    # Example 1: Compute Timestamp from POSIX `time()`.
+    #
+    #     Timestamp timestamp;
+    #     timestamp.set_seconds(time(NULL));
+    #     timestamp.set_nanos(0);
+    #
+    # Example 2: Compute Timestamp from POSIX `gettimeofday()`.
+    #
+    #     struct timeval tv;
+    #     gettimeofday(&tv, NULL);
+    #
+    #     Timestamp timestamp;
+    #     timestamp.set_seconds(tv.tv_sec);
+    #     timestamp.set_nanos(tv.tv_usec * 1000);
+    #
+    # Example 3: Compute Timestamp from Win32 `GetSystemTimeAsFileTime()`.
+    #
+    #     FILETIME ft;
+    #     GetSystemTimeAsFileTime(&ft);
+    #     UINT64 ticks = (((UINT64)ft.dwHighDateTime) << 32) | ft.dwLowDateTime;
+    #
+    #     // A Windows tick is 100 nanoseconds. Windows epoch 1601-01-01T00:00:00Z
+    #     // is 11644473600 seconds before Unix epoch 1970-01-01T00:00:00Z.
+    #     Timestamp timestamp;
+    #     timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL));
+    #     timestamp.set_nanos((INT32) ((ticks % 10000000) * 100));
+    #
+    # Example 4: Compute Timestamp from Java `System.currentTimeMillis()`.
+    #
+    #     long millis = System.currentTimeMillis();
+    #
+    #     Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
+    #         .setNanos((int) ((millis % 1000) * 1000000)).build();
+    #
+    # Example 5: Compute Timestamp from Java `Instant.now()`.
+    #
+    #     Instant now = Instant.now();
+    #
+    #     Timestamp timestamp =
+    #         Timestamp.newBuilder().setSeconds(now.getEpochSecond())
+    #             .setNanos(now.getNano()).build();
+    #
+    # Example 6: Compute Timestamp from current time in Python.
+    #
+    #     timestamp = Timestamp()
+    #     timestamp.GetCurrentTime()
+    #
+    # # JSON Mapping
+    #
+    # In JSON format, the Timestamp type is encoded as a string in the
+    # [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) format. That is, the
+    # format is "\\{year}-\\{month}-\\{day}T\\{hour}:\\{min}:\\{sec}[.\\{frac_sec}]Z"
+    # where \\{year} is always expressed using four digits while \\{month}, \\{day},
+    # \\{hour}, \\{min}, and \\{sec} are zero-padded to two digits each. The fractional
+    # seconds, which can go up to 9 digits (i.e. up to 1 nanosecond resolution),
+    # are optional. The "Z" suffix indicates the timezone ("UTC"); the timezone
+    # is required. A proto3 JSON serializer should always use UTC (as indicated by
+    # "Z") when printing the Timestamp type and a proto3 JSON parser should be
+    # able to accept both UTC and other timezones (as indicated by an offset).
+    #
+    # For example, "2017-01-15T01:30:15.01Z" encodes 15.01 seconds past
+    # 01:30 UTC on January 15, 2017.
+    #
+    # In JavaScript, one can convert a Date object to this format using the
+    # standard
+    # [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
+    # method. In Python, a standard `datetime.datetime` object can be converted
+    # to this format using
+    # [`strftime`](https://docs.python.org/2/library/time.html#time.strftime) with
+    # the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use
+    # the Joda Time's [`ISODateTimeFormat.dateTime()`](
+    # http://joda-time.sourceforge.net/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime()
+    # ) to obtain a formatter capable of generating timestamps in this format.
+    # @!attribute [rw] seconds
+    #   @return [::Integer]
+    #     Represents seconds of UTC time since Unix epoch
+    #     1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to
+    #     9999-12-31T23:59:59Z inclusive.
+    # @!attribute [rw] nanos
+    #   @return [::Integer]
+    #     Non-negative fractions of a second at nanosecond resolution. Negative
+    #     second values with fractions must still have non-negative nanos values
+    #     that count forward in time. Must be from 0 to 999,999,999
+    #     inclusive.
+    class Timestamp
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

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

@@ -0,0 +1,231 @@
+# 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 DataSources
+        module V1
+          # The [data source](/merchant/api/guides/data-sources/overview) for
+          # the Merchant Center account.
+          # @!attribute [rw] primary_product_data_source
+          #   @return [::Google::Shopping::Merchant::DataSources::V1::PrimaryProductDataSource]
+          #     The [primary data
+          #     source](https://support.google.com/merchants/answer/7439058) for local
+          #     and online products.
+          #
+          #     Note: The following fields are mutually exclusive: `primary_product_data_source`, `supplemental_product_data_source`, `local_inventory_data_source`, `regional_inventory_data_source`, `promotion_data_source`, `product_review_data_source`, `merchant_review_data_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] supplemental_product_data_source
+          #   @return [::Google::Shopping::Merchant::DataSources::V1::SupplementalProductDataSource]
+          #     The [supplemental data
+          #     source](https://support.google.com/merchants/answer/7439058) for local
+          #     and online products.
+          #
+          #     Note: The following fields are mutually exclusive: `supplemental_product_data_source`, `primary_product_data_source`, `local_inventory_data_source`, `regional_inventory_data_source`, `promotion_data_source`, `product_review_data_source`, `merchant_review_data_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] local_inventory_data_source
+          #   @return [::Google::Shopping::Merchant::DataSources::V1::LocalInventoryDataSource]
+          #     The [local
+          #     inventory](https://support.google.com/merchants/answer/7023001) data
+          #     source.
+          #
+          #     Note: The following fields are mutually exclusive: `local_inventory_data_source`, `primary_product_data_source`, `supplemental_product_data_source`, `regional_inventory_data_source`, `promotion_data_source`, `product_review_data_source`, `merchant_review_data_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] regional_inventory_data_source
+          #   @return [::Google::Shopping::Merchant::DataSources::V1::RegionalInventoryDataSource]
+          #     The [regional
+          #     inventory](https://support.google.com/merchants/answer/7439058) data
+          #     source.
+          #
+          #     Note: The following fields are mutually exclusive: `regional_inventory_data_source`, `primary_product_data_source`, `supplemental_product_data_source`, `local_inventory_data_source`, `promotion_data_source`, `product_review_data_source`, `merchant_review_data_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] promotion_data_source
+          #   @return [::Google::Shopping::Merchant::DataSources::V1::PromotionDataSource]
+          #     The [promotion](https://support.google.com/merchants/answer/2906014)
+          #     data source.
+          #
+          #     Note: The following fields are mutually exclusive: `promotion_data_source`, `primary_product_data_source`, `supplemental_product_data_source`, `local_inventory_data_source`, `regional_inventory_data_source`, `product_review_data_source`, `merchant_review_data_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] product_review_data_source
+          #   @return [::Google::Shopping::Merchant::DataSources::V1::ProductReviewDataSource]
+          #     The [product
+          #     review](https://support.google.com/merchants/answer/7045996)
+          #     data source.
+          #
+          #     Note: The following fields are mutually exclusive: `product_review_data_source`, `primary_product_data_source`, `supplemental_product_data_source`, `local_inventory_data_source`, `regional_inventory_data_source`, `promotion_data_source`, `merchant_review_data_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] merchant_review_data_source
+          #   @return [::Google::Shopping::Merchant::DataSources::V1::MerchantReviewDataSource]
+          #     The [merchant
+          #     review](https://support.google.com/merchants/answer/7045996)
+          #     data source.
+          #
+          #     Note: The following fields are mutually exclusive: `merchant_review_data_source`, `primary_product_data_source`, `supplemental_product_data_source`, `local_inventory_data_source`, `regional_inventory_data_source`, `promotion_data_source`, `product_review_data_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Required. Identifier. The name of the data source.
+          #     Format:
+          #     `accounts/{account}/dataSources/{datasource}`
+          # @!attribute [r] data_source_id
+          #   @return [::Integer]
+          #     Output only. The data source id.
+          # @!attribute [rw] display_name
+          #   @return [::String]
+          #     Required. The displayed data source name in the Merchant Center UI.
+          # @!attribute [r] input
+          #   @return [::Google::Shopping::Merchant::DataSources::V1::DataSource::Input]
+          #     Output only. Determines the type of input to the data source. Based on the
+          #     input some settings might not work. Only generic data sources can be
+          #     created through the API.
+          # @!attribute [rw] file_input
+          #   @return [::Google::Shopping::Merchant::DataSources::V1::FileInput]
+          #     Optional. The field is used only when data is managed through a file.
+          class DataSource
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Determines the type of input to the data source. Based on the input some
+            # settings might not be supported.
+            module Input
+              # Input unspecified.
+              INPUT_UNSPECIFIED = 0
+
+              # Represents data sources for which the data is primarily provided through
+              # the API.
+              API = 1
+
+              # Represents data sources for which the data is primarily provided through
+              # file input. Data can still be provided through the API.
+              FILE = 2
+
+              # The data source for products added directly in Merchant Center.
+              #
+              # This type of data source can not be created or updated through this API,
+              # only by Merchant Center UI.
+              #
+              # This type of data source is read only.
+              UI = 3
+
+              # This is also known as
+              # [Automated feeds](https://support.google.com/merchants/answer/12158480)
+              # used to automatically build your product data. This type of data source
+              # can be enabled or disabled through the Accounts sub-API.
+              AUTOFEED = 4
+            end
+          end
+
+          # Request message for the GetDataSource method.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Required. The name of the data source to retrieve.
+          #     Format: `accounts/{account}/dataSources/{datasource}`
+          class GetDataSourceRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for the ListDataSources method.
+          # @!attribute [rw] parent
+          #   @return [::String]
+          #     Required. The account to list data sources for.
+          #     Format: `accounts/{account}`
+          # @!attribute [rw] page_size
+          #   @return [::Integer]
+          #     Optional. The maximum number of data sources to return. The service may
+          #     return fewer than this value. The maximum value is 1000; values above 1000
+          #     will be coerced to 1000. If unspecified, the maximum number of data sources
+          #     will be returned.
+          # @!attribute [rw] page_token
+          #   @return [::String]
+          #     Optional. A page token, received from a previous `ListDataSources` call.
+          #     Provide this to retrieve the subsequent page.
+          #
+          #     When paginating, all other parameters provided to `ListDataSources`
+          #     must match the call that provided the page token.
+          class ListDataSourcesRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Response message for the ListDataSources method.
+          # @!attribute [rw] data_sources
+          #   @return [::Array<::Google::Shopping::Merchant::DataSources::V1::DataSource>]
+          #     The data sources 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 ListDataSourcesResponse
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for the CreateDataSource method.
+          # @!attribute [rw] parent
+          #   @return [::String]
+          #     Required. The account where this data source will be created.
+          #     Format: `accounts/{account}`
+          # @!attribute [rw] data_source
+          #   @return [::Google::Shopping::Merchant::DataSources::V1::DataSource]
+          #     Required. The data source to create.
+          class CreateDataSourceRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for the UpdateDataSource method.
+          # @!attribute [rw] data_source
+          #   @return [::Google::Shopping::Merchant::DataSources::V1::DataSource]
+          #     Required. The data source resource to update.
+          # @!attribute [rw] update_mask
+          #   @return [::Google::Protobuf::FieldMask]
+          #     Required. The list of data source fields to be updated.
+          #
+          #     Fields specified in the update mask without a value specified in the
+          #     body will be deleted from the data source.
+          #
+          #     Providing special "*" value for full data source replacement is not
+          #     supported.
+          #
+          #     For example, If you insert `updateMask=displayName` in the request, it will
+          #     only update the `displayName` leaving all other fields untouched.
+          class UpdateDataSourceRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for the FetchDataSource method.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Required. The name of the data source resource to fetch.
+          #     Format: `accounts/{account}/dataSources/{datasource}`
+          class FetchDataSourceRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for the DeleteDataSource method.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Required. The name of the data source to delete.
+          #     Format: `accounts/{account}/dataSources/{datasource}`
+          class DeleteDataSourceRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/shopping/merchant/datasources/v1/datasourcetypes.rb

@@ -0,0 +1,298 @@
+# 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 DataSources
+        module V1
+          # The primary data source for local and online products.
+          # @!attribute [rw] legacy_local
+          #   @return [::Boolean]
+          #     Optional. Immutable. Determines whether the products of this data source
+          #     are **only** targeting local destinations. Legacy local products are
+          #     prefixed with `local~` in the product resource ID. For example,
+          #     `accounts/123/products/local~en~US~sku123`.
+          # @!attribute [rw] feed_label
+          #   @return [::String]
+          #     Optional. Immutable. The feed label that is specified on the data source
+          #     level.
+          #
+          #     Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9),
+          #     and dashes (-).
+          #
+          #     See also [migration to feed
+          #     labels](https://developers.google.com/shopping-content/guides/products/feed-labels).
+          #
+          #     `feedLabel` and `contentLanguage` must be either both set or unset for data
+          #     sources with product content type.
+          #     They must be set for data sources with a file input.
+          #
+          #     If set, the data source will only accept products matching this
+          #     combination. If unset, the data source will accept products without that
+          #     restriction.
+          # @!attribute [rw] content_language
+          #   @return [::String]
+          #     Optional. Immutable. The two-letter ISO 639-1 language of the items in the
+          #     data source.
+          #
+          #     `feedLabel` and `contentLanguage` must be either both set or unset.
+          #     The fields can only be unset for data sources without file input.
+          #
+          #     If set, the data source will only accept products matching this
+          #     combination. If unset, the data source will accept products without that
+          #     restriction.
+          # @!attribute [rw] countries
+          #   @return [::Array<::String>]
+          #     Optional. The countries where the items may be displayed. Represented as a
+          #     [CLDR territory
+          #     code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml).
+          # @!attribute [rw] default_rule
+          #   @return [::Google::Shopping::Merchant::DataSources::V1::PrimaryProductDataSource::DefaultRule]
+          #     Optional. Default rule management of the data source. If set, the linked
+          #     data sources will be replaced.
+          # @!attribute [r] contains_custom_rules
+          #   @return [::Boolean]
+          #     Output only. The existing data source setup contains at least one custom
+          #     (non-default) rule and therefore its management through the
+          #     `default_rule_data_sources` field should be treated with caution.
+          # @!attribute [rw] destinations
+          #   @return [::Array<::Google::Shopping::Merchant::DataSources::V1::PrimaryProductDataSource::Destination>]
+          #     Optional. A list of destinations describing where products of the data
+          #     source can be shown.
+          #
+          #     When retrieving the data source, the list contains all the destinations
+          #     that can be used for the data source, including the ones that are disabled
+          #     for the data source but enabled for the account.
+          #
+          #     Only destinations that are enabled on the account, for example through
+          #     program participation, can be enabled on the data source.
+          #
+          #     If unset, during creation, the destinations will be inherited based on the
+          #     account level program participation.
+          #
+          #     If set, during creation or update, the data source will be set only for the
+          #     specified destinations.
+          #
+          #     Updating this field requires at least one destination.
+          class PrimaryProductDataSource
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Default rule management of the data source.
+            # @!attribute [rw] take_from_data_sources
+            #   @return [::Array<::Google::Shopping::Merchant::DataSources::V1::DataSourceReference>]
+            #     Required. The list of data sources linked in the [default
+            #     rule](https://support.google.com/merchants/answer/7450276).
+            #     This list is ordered by the default rule priority of joining the data.
+            #     It might include none or multiple references to `self` and supplemental
+            #     data sources.
+            #
+            #     The list must not be empty.
+            #
+            #     To link the data source to the default rule, you need to add a
+            #     new reference to this list (in sequential order).
+            #
+            #     To unlink the data source from the default rule, you need to
+            #     remove the given reference from this list.
+            #
+            #     Changing the order of this list will result in changing the priority of
+            #     data sources in the default rule.
+            #
+            #     For example, providing the following list: [`1001`, `self`] will
+            #     take attribute values from supplemental data source `1001`, and fallback
+            #     to `self` if the attribute is not set in `1001`.
+            class DefaultRule
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Destinations also known as [Marketing
+            # methods](https://support.google.com/merchants/answer/15130232) selections.
+            # @!attribute [rw] destination
+            #   @return [::Google::Shopping::Type::Destination::DestinationEnum]
+            #     [Marketing methods](https://support.google.com/merchants/answer/15130232)
+            #     (also known as destination) selections.
+            # @!attribute [rw] state
+            #   @return [::Google::Shopping::Merchant::DataSources::V1::PrimaryProductDataSource::Destination::State]
+            #     The state of the destination.
+            class Destination
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+
+              # The state of the destination.
+              module State
+                # Not specified.
+                STATE_UNSPECIFIED = 0
+
+                # Indicates that the destination is enabled.
+                ENABLED = 1
+
+                # Indicates that the destination is disabled.
+                DISABLED = 2
+              end
+            end
+          end
+
+          # The supplemental data source for local and online products. After creation,
+          # you should make sure to link the supplemental product data source into one or
+          # more primary product data sources.
+          # @!attribute [rw] feed_label
+          #   @return [::String]
+          #     Optional. Immutable. The feed label that is specified on the data source
+          #     level.
+          #
+          #     Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9),
+          #     and dashes (-).
+          #
+          #     See also [migration to feed
+          #     labels](https://developers.google.com/shopping-content/guides/products/feed-labels).
+          #
+          #     `feedLabel` and `contentLanguage` must be either both set or unset for data
+          #     sources with product content type.
+          #
+          #     They must be set for data sources with a [file
+          #     input][google.shopping.merchant.datasources.v1.FileInput].
+          #     The fields must be unset for data sources without [file
+          #     input][google.shopping.merchant.datasources.v1.FileInput].
+          #
+          #     If set, the data source will only accept products matching this
+          #     combination. If unset, the data source will accept produts without that
+          #     restriction.
+          # @!attribute [rw] content_language
+          #   @return [::String]
+          #     Optional. Immutable. The two-letter ISO 639-1 language of the items in the
+          #     data source.
+          #
+          #     `feedLabel` and `contentLanguage` must be either both set or unset.
+          #     The fields can only be unset for data sources without file input.
+          #
+          #     If set, the data source will only accept products matching this
+          #     combination. If unset, the data source will accept produts without that
+          #     restriction.
+          # @!attribute [r] referencing_primary_data_sources
+          #   @return [::Array<::Google::Shopping::Merchant::DataSources::V1::DataSourceReference>]
+          #     Output only. The (unordered and deduplicated) list of all primary data
+          #     sources linked to this data source in either default or custom rules.
+          #     Supplemental data source cannot be deleted before all links are removed.
+          class SupplementalProductDataSource
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The local inventory data source type is only available for file inputs and
+          # can't be used to create API local inventory data sources.
+          # @!attribute [rw] feed_label
+          #   @return [::String]
+          #     Required. Immutable. The feed label of the offers to which the local
+          #     inventory is provided.
+          #
+          #     Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9),
+          #     and dashes (-).
+          #
+          #     See also [migration to feed
+          #     labels](https://developers.google.com/shopping-content/guides/products/feed-labels).
+          # @!attribute [rw] content_language
+          #   @return [::String]
+          #     Required. Immutable. The two-letter ISO 639-1 language of the items to
+          #     which the local inventory is provided.
+          class LocalInventoryDataSource
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # @!attribute [rw] feed_label
+          #   @return [::String]
+          #     Required. Immutable. The feed label of the offers to which the regional
+          #     inventory is provided.
+          #
+          #     Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9),
+          #     and dashes (-).
+          #
+          #     See also [migration to feed
+          #     labels](https://developers.google.com/shopping-content/guides/products/feed-labels).
+          # @!attribute [rw] content_language
+          #   @return [::String]
+          #     Required. Immutable. The two-letter ISO 639-1 language of the items to
+          #     which the regional inventory is provided.
+          class RegionalInventoryDataSource
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The promotion data source.
+          # @!attribute [rw] target_country
+          #   @return [::String]
+          #     Required. Immutable. The target country used as part of the unique
+          #     identifier. Represented as a [CLDR territory
+          #     code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml).
+          #
+          #     Promotions are only available in selected
+          #     [countries](https://support.google.com/merchants/answer/4588460).
+          # @!attribute [rw] content_language
+          #   @return [::String]
+          #     Required. Immutable. The two-letter ISO 639-1 language of the items in the
+          #     data source.
+          class PromotionDataSource
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The product review data source.
+          class ProductReviewDataSource
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The merchant review data source.
+          class MerchantReviewDataSource
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Data source reference can be used to manage related data sources within the
+          # data source service.
+          # @!attribute [rw] self
+          #   @return [::Boolean]
+          #     Self should be used to reference the primary data source itself.
+          #
+          #     Note: The following fields are mutually exclusive: `self`, `primary_data_source_name`, `supplemental_data_source_name`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] primary_data_source_name
+          #   @return [::String]
+          #     Optional. The name of the primary data source.
+          #     Format:
+          #     `accounts/{account}/dataSources/{datasource}`
+          #
+          #     Note: The following fields are mutually exclusive: `primary_data_source_name`, `self`, `supplemental_data_source_name`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] supplemental_data_source_name
+          #   @return [::String]
+          #     Optional. The name of the supplemental data source.
+          #     Format:
+          #     `accounts/{account}/dataSources/{datasource}`
+          #
+          #     Note: The following fields are mutually exclusive: `supplemental_data_source_name`, `self`, `primary_data_source_name`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          class DataSourceReference
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end