google-shopping-merchant-inventories-v1beta 0.a → 0.2.0

data/proto_docs/google/shopping/merchant/inventories/v1beta/regionalinventory.rb

@@ -0,0 +1,142 @@
+# frozen_string_literal: true
+
+# Copyright 2023 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 Inventories
+        module V1beta
+          # Regional inventory information for the product. Represents specific
+          # information like price and availability for a given product in a specific
+          # {::Google::Shopping::Merchant::Inventories::V1beta::RegionalInventory#region `region`}.
+          # For a list of all accepted attribute values, see the [regional product
+          # inventory feed
+          # specification](https://support.google.com/merchants/answer/9698880).
+          # @!attribute [r] name
+          #   @return [::String]
+          #     Output only. The name of the `RegionalInventory` resource.
+          #     Format:
+          #     `{regional_inventory.name=accounts/{account}/products/{product}/regionalInventories/{region}`
+          # @!attribute [r] account
+          #   @return [::Integer]
+          #     Output only. The account that owns the product. This field will be ignored
+          #     if set by the client.
+          # @!attribute [rw] region
+          #   @return [::String]
+          #     Required. ID of the region for this
+          #     `RegionalInventory` resource. See the [Regional availability and
+          #     pricing](https://support.google.com/merchants/answer/9698880) for more
+          #     details.
+          # @!attribute [rw] price
+          #   @return [::Google::Shopping::Type::Price]
+          #     Price of the product in this region.
+          # @!attribute [rw] sale_price
+          #   @return [::Google::Shopping::Type::Price]
+          #     Sale price of the product in this region. Mandatory if
+          #     {::Google::Shopping::Merchant::Inventories::V1beta::RegionalInventory#sale_price_effective_date `salePriceEffectiveDate`}
+          #     is defined.
+          # @!attribute [rw] sale_price_effective_date
+          #   @return [::Google::Type::Interval]
+          #     The `TimePeriod` of the
+          #     sale price in this region.
+          # @!attribute [rw] availability
+          #   @return [::String]
+          #     Availability of the product in this region.
+          #     For accepted attribute values, see the [regional product inventory feed
+          #     specification](https://support.google.com/merchants/answer/3061342)
+          # @!attribute [rw] custom_attributes
+          #   @return [::Array<::Google::Shopping::Type::CustomAttribute>]
+          #     A list of custom (merchant-provided) attributes. You can also use
+          #     `CustomAttribute` to submit any attribute of the feed specification in its
+          #     generic form.
+          class RegionalInventory
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for the `ListRegionalInventories` method.
+          # @!attribute [rw] parent
+          #   @return [::String]
+          #     Required. The `name` of the parent product to list `RegionalInventory`
+          #     resources for. Format: `accounts/{account}/products/{product}`
+          # @!attribute [rw] page_size
+          #   @return [::Integer]
+          #     The maximum number of `RegionalInventory` resources for the given product
+          #     to return. The service returns fewer than this value if the number of
+          #     inventories for the given product is less that than the `pageSize`. The
+          #     default value is 25000. The maximum value is 100000; If a value higher than
+          #     the maximum is specified, then the `pageSize` will default to the maximum.
+          # @!attribute [rw] page_token
+          #   @return [::String]
+          #     A page token, received from a previous `ListRegionalInventories` call.
+          #     Provide the page token to retrieve the subsequent page.
+          #
+          #     When paginating, all other parameters provided to `ListRegionalInventories`
+          #     must match the call that provided the page token. The token returned as
+          #     {::Google::Shopping::Merchant::Inventories::V1beta::ListRegionalInventoriesResponse#next_page_token nextPageToken}
+          #     in the response to the previous request.
+          class ListRegionalInventoriesRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Response message for the `ListRegionalInventories` method.
+          # @!attribute [rw] regional_inventories
+          #   @return [::Array<::Google::Shopping::Merchant::Inventories::V1beta::RegionalInventory>]
+          #     The `RegionalInventory` resources for the given product from the specified
+          #     account.
+          # @!attribute [rw] next_page_token
+          #   @return [::String]
+          #     A token, which can be sent as `pageToken` to retrieve the next page.
+          #     If this field is omitted, there are no subsequent pages.
+          class ListRegionalInventoriesResponse
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for the `InsertRegionalInventory` method.
+          # @!attribute [rw] parent
+          #   @return [::String]
+          #     Required. The account and product where this inventory will be inserted.
+          #     Format: `accounts/{account}/products/{product}`
+          # @!attribute [rw] regional_inventory
+          #   @return [::Google::Shopping::Merchant::Inventories::V1beta::RegionalInventory]
+          #     Required. Regional inventory information to add to the product. If the
+          #     product already has a `RegionalInventory` resource for the same `region`,
+          #     full replacement of the `RegionalInventory` resource is performed.
+          class InsertRegionalInventoryRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Request message for the `DeleteRegionalInventory` method.
+          # @!attribute [rw] name
+          #   @return [::String]
+          #     Required. The name of the `RegionalInventory` resource to delete.
+          #     Format:
+          #     `accounts/{account}/products/{product}/regionalInventories/{region}`
+          class DeleteRegionalInventoryRequest
+            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,175 @@
+# frozen_string_literal: true
+
+# Copyright 2023 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 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).
+      #     This field can also be set as infinity by setting to -1.
+      #     This field only support -1 and positive value.
+      # @!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, [Discovery
+      # 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
+
+          # [Discovery and Demand Gen
+          # ads](https://support.google.com/merchants/answer/13389785).
+          DISCOVERY_ADS = 2
+
+          # [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

data/proto_docs/google/type/interval.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+# Copyright 2023 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 Type
+    # Represents a time interval, encoded as a Timestamp start (inclusive) and a
+    # Timestamp end (exclusive).
+    #
+    # The start must be less than or equal to the end.
+    # When the start equals the end, the interval is empty (matches no time).
+    # When both start and end are unspecified, the interval matches any time.
+    # @!attribute [rw] start_time
+    #   @return [::Google::Protobuf::Timestamp]
+    #     Optional. Inclusive start of the interval.
+    #
+    #     If specified, a Timestamp matching this interval will have to be the same
+    #     or after the start.
+    # @!attribute [rw] end_time
+    #   @return [::Google::Protobuf::Timestamp]
+    #     Optional. Exclusive end of the interval.
+    #
+    #     If specified, a Timestamp matching this interval will have to be before the
+    #     end.
+    class Interval
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

metadata

@@ -1,28 +1,228 @@
 --- !ruby/object:Gem::Specification
 name: google-shopping-merchant-inventories-v1beta
 version: !ruby/object:Gem::Version
-  version: 0.a
+  version: 0.2.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-10-17 00:00:00.000000000 Z
-dependencies: []
-description: Placeholder for the future Google-authored gem google-shopping-merchant-inventories-v1beta.
-  This placeholder is being released on 2023-10-17 in order to reserve the name. The
-  final gem should be available shortly after that date. If it has not been released
-  in a timely manner, or if this placeholder interferes with your work, you can contact
-  the Google Ruby team by opening an issue in the GitHub repository https://github.com/googleapis/google-cloud-ruby.
+date: 2024-01-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: gapic-common
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.21.1
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.a
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.21.1
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.a
+- !ruby/object:Gem::Dependency
+  name: google-cloud-errors
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: google-shopping-type
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.a
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 2.a
+- !ruby/object:Gem::Dependency
+  name: google-style
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.26.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.26.3
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.16'
+- !ruby/object:Gem::Dependency
+  name: minitest-focus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: minitest-rg
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.2'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.18'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: Programmatically manage your Merchant Center accounts. Note that google-shopping-merchant-inventories-v1beta
+  is a version-specific client library. For most uses, we recommend installing the
+  main client library google-shopping-merchant-inventories instead. See the readme
+  for more details.
 email: googleapis-packages@google.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".yardopts"
+- AUTHENTICATION.md
 - LICENSE.md
 - README.md
+- lib/google-shopping-merchant-inventories-v1beta.rb
+- lib/google/shopping/merchant/inventories/v1beta.rb
+- lib/google/shopping/merchant/inventories/v1beta/local_inventory_service.rb
+- lib/google/shopping/merchant/inventories/v1beta/local_inventory_service/client.rb
+- lib/google/shopping/merchant/inventories/v1beta/local_inventory_service/credentials.rb
+- lib/google/shopping/merchant/inventories/v1beta/local_inventory_service/paths.rb
+- lib/google/shopping/merchant/inventories/v1beta/local_inventory_service/rest.rb
+- lib/google/shopping/merchant/inventories/v1beta/local_inventory_service/rest/client.rb
+- lib/google/shopping/merchant/inventories/v1beta/local_inventory_service/rest/service_stub.rb
+- lib/google/shopping/merchant/inventories/v1beta/localinventory_pb.rb
+- lib/google/shopping/merchant/inventories/v1beta/localinventory_services_pb.rb
+- lib/google/shopping/merchant/inventories/v1beta/regional_inventory_service.rb
+- lib/google/shopping/merchant/inventories/v1beta/regional_inventory_service/client.rb
+- lib/google/shopping/merchant/inventories/v1beta/regional_inventory_service/credentials.rb
+- lib/google/shopping/merchant/inventories/v1beta/regional_inventory_service/paths.rb
+- lib/google/shopping/merchant/inventories/v1beta/regional_inventory_service/rest.rb
+- lib/google/shopping/merchant/inventories/v1beta/regional_inventory_service/rest/client.rb
+- lib/google/shopping/merchant/inventories/v1beta/regional_inventory_service/rest/service_stub.rb
+- lib/google/shopping/merchant/inventories/v1beta/regionalinventory_pb.rb
+- lib/google/shopping/merchant/inventories/v1beta/regionalinventory_services_pb.rb
+- lib/google/shopping/merchant/inventories/v1beta/rest.rb
 - lib/google/shopping/merchant/inventories/v1beta/version.rb
+- proto_docs/README.md
+- proto_docs/google/api/client.rb
+- proto_docs/google/api/field_behavior.rb
+- proto_docs/google/api/launch_stage.rb
+- proto_docs/google/api/resource.rb
+- proto_docs/google/protobuf/duration.rb
+- proto_docs/google/protobuf/empty.rb
+- proto_docs/google/protobuf/timestamp.rb
+- proto_docs/google/shopping/merchant/inventories/v1beta/localinventory.rb
+- proto_docs/google/shopping/merchant/inventories/v1beta/regionalinventory.rb
+- proto_docs/google/shopping/type/types.rb
+- proto_docs/google/type/interval.rb
 homepage: https://github.com/googleapis/google-cloud-ruby
 licenses:
 - Apache-2.0
@@ -35,15 +235,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '2.6'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
-rubygems_version: 3.4.19
+rubygems_version: 3.5.3
 signing_key: 
 specification_version: 4
-summary: Placeholder for the future Google-authored gem google-shopping-merchant-inventories-v1beta
+summary: Programmatically manage your Merchant Center accounts.
 test_files: []