google-apis-manufacturers_v1 0.1.0

data/lib/google/apis/manufacturers_v1/gem_version.rb

@@ -0,0 +1,28 @@
+# Copyright 2020 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
+#
+#      http://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.
+
+module Google
+  module Apis
+    module ManufacturersV1
+      # Version of the google-apis-manufacturers_v1 gem
+      GEM_VERSION = "0.1.0"
+
+      # Version of the code generator used to generate this client
+      GENERATOR_VERSION = "0.1.1"
+
+      # Revision of the discovery document this client was generated from
+      REVISION = "20201208"
+    end
+  end
+end

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

@@ -0,0 +1,253 @@
+# Copyright 2020 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
+#
+#      http://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.
+
+require 'date'
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module ManufacturersV1
+      
+      class Attributes
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Capacity
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Count
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class DestinationStatus
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Empty
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class FeatureDescription
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Image
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Issue
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ListProductsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Price
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Product
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ProductDetail
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Attributes
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :additional_image_link, as: 'additionalImageLink', class: Google::Apis::ManufacturersV1::Image, decorator: Google::Apis::ManufacturersV1::Image::Representation
+      
+          property :age_group, as: 'ageGroup'
+          property :brand, as: 'brand'
+          property :capacity, as: 'capacity', class: Google::Apis::ManufacturersV1::Capacity, decorator: Google::Apis::ManufacturersV1::Capacity::Representation
+      
+          property :color, as: 'color'
+          property :count, as: 'count', class: Google::Apis::ManufacturersV1::Count, decorator: Google::Apis::ManufacturersV1::Count::Representation
+      
+          property :description, as: 'description'
+          property :disclosure_date, as: 'disclosureDate'
+          collection :excluded_destination, as: 'excludedDestination'
+          collection :feature_description, as: 'featureDescription', class: Google::Apis::ManufacturersV1::FeatureDescription, decorator: Google::Apis::ManufacturersV1::FeatureDescription::Representation
+      
+          property :flavor, as: 'flavor'
+          property :format, as: 'format'
+          property :gender, as: 'gender'
+          collection :gtin, as: 'gtin'
+          property :image_link, as: 'imageLink', class: Google::Apis::ManufacturersV1::Image, decorator: Google::Apis::ManufacturersV1::Image::Representation
+      
+          collection :included_destination, as: 'includedDestination'
+          property :item_group_id, as: 'itemGroupId'
+          property :material, as: 'material'
+          property :mpn, as: 'mpn'
+          property :pattern, as: 'pattern'
+          collection :product_detail, as: 'productDetail', class: Google::Apis::ManufacturersV1::ProductDetail, decorator: Google::Apis::ManufacturersV1::ProductDetail::Representation
+      
+          property :product_line, as: 'productLine'
+          property :product_name, as: 'productName'
+          property :product_page_url, as: 'productPageUrl'
+          collection :product_type, as: 'productType'
+          property :release_date, as: 'releaseDate'
+          collection :rich_product_content, as: 'richProductContent'
+          property :scent, as: 'scent'
+          property :size, as: 'size'
+          property :size_system, as: 'sizeSystem'
+          property :size_type, as: 'sizeType'
+          property :suggested_retail_price, as: 'suggestedRetailPrice', class: Google::Apis::ManufacturersV1::Price, decorator: Google::Apis::ManufacturersV1::Price::Representation
+      
+          property :target_client_id, as: 'targetClientId'
+          property :theme, as: 'theme'
+          property :title, as: 'title'
+          collection :video_link, as: 'videoLink'
+        end
+      end
+      
+      class Capacity
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :unit, as: 'unit'
+          property :value, :numeric_string => true, as: 'value'
+        end
+      end
+      
+      class Count
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :unit, as: 'unit'
+          property :value, :numeric_string => true, as: 'value'
+        end
+      end
+      
+      class DestinationStatus
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :destination, as: 'destination'
+          property :status, as: 'status'
+        end
+      end
+      
+      class Empty
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class FeatureDescription
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :headline, as: 'headline'
+          property :image, as: 'image', class: Google::Apis::ManufacturersV1::Image, decorator: Google::Apis::ManufacturersV1::Image::Representation
+      
+          property :text, as: 'text'
+        end
+      end
+      
+      class Image
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :image_url, as: 'imageUrl'
+          property :status, as: 'status'
+          property :type, as: 'type'
+        end
+      end
+      
+      class Issue
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :attribute, as: 'attribute'
+          property :description, as: 'description'
+          property :destination, as: 'destination'
+          property :resolution, as: 'resolution'
+          property :severity, as: 'severity'
+          property :timestamp, as: 'timestamp'
+          property :title, as: 'title'
+          property :type, as: 'type'
+        end
+      end
+      
+      class ListProductsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :next_page_token, as: 'nextPageToken'
+          collection :products, as: 'products', class: Google::Apis::ManufacturersV1::Product, decorator: Google::Apis::ManufacturersV1::Product::Representation
+      
+        end
+      end
+      
+      class Price
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :amount, as: 'amount'
+          property :currency, as: 'currency'
+        end
+      end
+      
+      class Product
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :attributes, as: 'attributes', class: Google::Apis::ManufacturersV1::Attributes, decorator: Google::Apis::ManufacturersV1::Attributes::Representation
+      
+          property :content_language, as: 'contentLanguage'
+          collection :destination_statuses, as: 'destinationStatuses', class: Google::Apis::ManufacturersV1::DestinationStatus, decorator: Google::Apis::ManufacturersV1::DestinationStatus::Representation
+      
+          collection :issues, as: 'issues', class: Google::Apis::ManufacturersV1::Issue, decorator: Google::Apis::ManufacturersV1::Issue::Representation
+      
+          property :name, as: 'name'
+          property :parent, as: 'parent'
+          property :product_id, as: 'productId'
+          property :target_country, as: 'targetCountry'
+        end
+      end
+      
+      class ProductDetail
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :attribute_name, as: 'attributeName'
+          property :attribute_value, as: 'attributeValue'
+          property :section_name, as: 'sectionName'
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,239 @@
+# Copyright 2020 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
+#
+#      http://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.
+
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module ManufacturersV1
+      # Manufacturer Center API
+      #
+      # Public API for managing Manufacturer Center related data.
+      #
+      # @example
+      #    require 'google/apis/manufacturers_v1'
+      #
+      #    Manufacturers = Google::Apis::ManufacturersV1 # Alias the module
+      #    service = Manufacturers::ManufacturerCenterService.new
+      #
+      # @see https://developers.google.com/manufacturers/
+      class ManufacturerCenterService < Google::Apis::Core::BaseService
+        # @return [String]
+        #  API key. Your API key identifies your project and provides you with API access,
+        #  quota, and reports. Required unless you provide an OAuth 2.0 token.
+        attr_accessor :key
+
+        # @return [String]
+        #  Available to use for quota purposes for server-side applications. Can be any
+        #  arbitrary string assigned to a user, but should not exceed 40 characters.
+        attr_accessor :quota_user
+
+        def initialize
+          super('https://manufacturers.googleapis.com/', '',
+                client_name: 'google-apis-manufacturers_v1',
+                client_version: Google::Apis::ManufacturersV1::GEM_VERSION)
+          @batch_path = 'batch'
+        end
+        
+        # Deletes the product from a Manufacturer Center account.
+        # @param [String] parent
+        #   Parent ID in the format `accounts/`account_id``. `account_id` - The ID of the
+        #   Manufacturer Center account.
+        # @param [String] name
+        #   Name in the format ``target_country`:`content_language`:`product_id``. `
+        #   target_country` - The target country of the product as a CLDR territory code (
+        #   for example, US). `content_language` - The content language of the product as
+        #   a two-letter ISO 639-1 language code (for example, en). `product_id` - The ID
+        #   of the product. For more information, see https://support.google.com/
+        #   manufacturers/answer/6124116#id.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ManufacturersV1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ManufacturersV1::Empty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def delete_account_product(parent, name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v1/{+parent}/products/{+name}', options)
+          command.response_representation = Google::Apis::ManufacturersV1::Empty::Representation
+          command.response_class = Google::Apis::ManufacturersV1::Empty
+          command.params['parent'] = parent unless parent.nil?
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets the product from a Manufacturer Center account, including product issues.
+        # A recently updated product takes around 15 minutes to process. Changes are
+        # only visible after it has been processed. While some issues may be available
+        # once the product has been processed, other issues may take days to appear.
+        # @param [String] parent
+        #   Parent ID in the format `accounts/`account_id``. `account_id` - The ID of the
+        #   Manufacturer Center account.
+        # @param [String] name
+        #   Name in the format ``target_country`:`content_language`:`product_id``. `
+        #   target_country` - The target country of the product as a CLDR territory code (
+        #   for example, US). `content_language` - The content language of the product as
+        #   a two-letter ISO 639-1 language code (for example, en). `product_id` - The ID
+        #   of the product. For more information, see https://support.google.com/
+        #   manufacturers/answer/6124116#id.
+        # @param [Array<String>, String] include
+        #   The information to be included in the response. Only sections listed here will
+        #   be returned.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ManufacturersV1::Product] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ManufacturersV1::Product]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_account_product(parent, name, include: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}/products/{+name}', options)
+          command.response_representation = Google::Apis::ManufacturersV1::Product::Representation
+          command.response_class = Google::Apis::ManufacturersV1::Product
+          command.params['parent'] = parent unless parent.nil?
+          command.params['name'] = name unless name.nil?
+          command.query['include'] = include unless include.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists all the products in a Manufacturer Center account.
+        # @param [String] parent
+        #   Parent ID in the format `accounts/`account_id``. `account_id` - The ID of the
+        #   Manufacturer Center account.
+        # @param [Array<String>, String] include
+        #   The information to be included in the response. Only sections listed here will
+        #   be returned.
+        # @param [Fixnum] page_size
+        #   Maximum number of product statuses to return in the response, used for paging.
+        # @param [String] page_token
+        #   The token returned by the previous request.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ManufacturersV1::ListProductsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ManufacturersV1::ListProductsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_account_products(parent, include: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}/products', options)
+          command.response_representation = Google::Apis::ManufacturersV1::ListProductsResponse::Representation
+          command.response_class = Google::Apis::ManufacturersV1::ListProductsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['include'] = include unless include.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Inserts or updates the attributes of the product in a Manufacturer Center
+        # account. Creates a product with the provided attributes. If the product
+        # already exists, then all attributes are replaced with the new ones. The checks
+        # at upload time are minimal. All required attributes need to be present for a
+        # product to be valid. Issues may show up later after the API has accepted a new
+        # upload for a product and it is possible to overwrite an existing valid product
+        # with an invalid product. To detect this, you should retrieve the product and
+        # check it for issues once the new version is available. Uploaded attributes
+        # first need to be processed before they can be retrieved. Until then, new
+        # products will be unavailable, and retrieval of previously uploaded products
+        # will return the original state of the product.
+        # @param [String] parent
+        #   Parent ID in the format `accounts/`account_id``. `account_id` - The ID of the
+        #   Manufacturer Center account.
+        # @param [String] name
+        #   Name in the format ``target_country`:`content_language`:`product_id``. `
+        #   target_country` - The target country of the product as a CLDR territory code (
+        #   for example, US). `content_language` - The content language of the product as
+        #   a two-letter ISO 639-1 language code (for example, en). `product_id` - The ID
+        #   of the product. For more information, see https://support.google.com/
+        #   manufacturers/answer/6124116#id.
+        # @param [Google::Apis::ManufacturersV1::Attributes] attributes_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ManufacturersV1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ManufacturersV1::Empty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def update_account_product(parent, name, attributes_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:put, 'v1/{+parent}/products/{+name}', options)
+          command.request_representation = Google::Apis::ManufacturersV1::Attributes::Representation
+          command.request_object = attributes_object
+          command.response_representation = Google::Apis::ManufacturersV1::Empty::Representation
+          command.response_class = Google::Apis::ManufacturersV1::Empty
+          command.params['parent'] = parent unless parent.nil?
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+
+        protected
+
+        def apply_command_defaults(command)
+          command.query['key'] = key unless key.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+        end
+      end
+    end
+  end
+end