google-apis-content_v2_1 0.24.0 → 0.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e8e33a2662f79a68c8e517bae09150d13ff88a97b4733f5db251ba854bf51900
-  data.tar.gz: 44502926099d53ed6a59952be0f09c9800932ab6a87605fc5c77fb780e460078
+  metadata.gz: 5f059117b3b7b8e9aa10161e48c9673275dbf4917a90e7fa05e275492bcfe25d
+  data.tar.gz: 2ee70335b58e881f9d22c7248e0e2f624d5f38eea7f23d100328915be7226db4
 SHA512:
-  metadata.gz: 5a67cc46cbdc4514cf69a4b4570136aef3bf897101b5eed409639e81c13b382d7f51605684d5f963b0fb1c09e16bb05d4df59e9e0c1a0a00061141829a7a8251
-  data.tar.gz: e3c556618d916ae7c41ca700a4fea736f587daf07f66e4a2208ef4229df2a717687df855b81b3bfc687d12490de18b2676b12e44d9a22970b7814c3303d56872
+  metadata.gz: 4e4a18c79a53c3c35714923c26126aff6ba994f906bc9c744583327be50370ed0a7c99186546eedaace4863ed2ba2de65b8e9ac423b76a801414139fb653ca9d
+  data.tar.gz: cc72e43ebd5737f906d39d3dd434d9234f817b1ce3cef27a91bb2e0248601336d576f4010918ca6d2541c99f506c9966b8d338afb27b9c2fd44c27c32fe044c9

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Release history for google-apis-content_v2_1
 
+### v0.28.0 (2021-12-16)
+
+* Unspecified changes
+
+### v0.27.0 (2021-12-01)
+
+* Regenerated from discovery document revision 20211126
+
+### v0.26.0 (2021-11-02)
+
+* Regenerated from discovery document revision 20211027
+
+### v0.25.0 (2021-10-26)
+
+* Regenerated from discovery document revision 20211021
+
 ### v0.24.0 (2021-10-12)
 
 * Regenerated from discovery document revision 20211007

data/OVERVIEW.md

@@ -51,7 +51,7 @@ require "google/apis/content_v2_1"
 client = Google::Apis::ContentV2_1::ShoppingContentService.new
 
 # Authenticate calls
-client.authentication = # ... use the googleauth gem to create credentials
+client.authorization = # ... use the googleauth gem to create credentials
 ```
 
 See the class reference docs for information on the methods you can call from a client.
@@ -60,8 +60,8 @@ See the class reference docs for information on the methods you can call from a
 
 More detailed descriptions of the Google simple REST clients are available in two documents.
 
- *  The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
- *  The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
+ *  The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
+ *  The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
 
 (Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Content service in particular.)
 

data/lib/google/apis/content_v2_1/classes.rb

@@ -64,8 +64,8 @@ module Google
         # @return [Fixnum]
         attr_accessor :css_id
       
-        # The GMB account which is linked or in the process of being linked with the
-        # Merchant Center account.
+        # The Business Profile which is linked or in the process of being linked with
+        # the Merchant Center account.
         # Corresponds to the JSON property `googleMyBusinessLink`
         # @return [Google::Apis::ContentV2_1::AccountGoogleMyBusinessLink]
         attr_accessor :google_my_business_link
@@ -251,7 +251,7 @@ module Google
       
         # Verification status of the phone number of the business. This status is read
         # only and can be updated only by successful phone verification. Acceptable
-        # values are: - "`verified`" - "`unverified`" "`unspecified`" -
+        # values are: - "`verified`" - "`unverified`"
         # Corresponds to the JSON property `phoneVerificationStatus`
         # @return [String]
         attr_accessor :phone_verification_status
@@ -337,21 +337,22 @@ module Google
       class AccountGoogleMyBusinessLink
         include Google::Apis::Core::Hashable
       
-        # The ID of the GMB account. If this is provided, then `gmbEmail` is ignored.
-        # The value of this field should match the `accountId` used by the GMB API.
+        # The ID of the Business Profile. If this is provided, then `gmbEmail` is
+        # ignored. The value of this field should match the `accountId` used by the
+        # Business Profile API.
         # Corresponds to the JSON property `gmbAccountId`
         # @return [String]
         attr_accessor :gmb_account_id
       
-        # The GMB email address of which a specific account within a GMB account. A
-        # sample account within a GMB account could be a business account with set of
-        # locations, managed under the GMB account.
+        # The Business Profile email address of a specific account within a Business
+        # Profile. A sample account within a Business Profile could be a business
+        # account with set of locations, managed under the Business Profile.
         # Corresponds to the JSON property `gmbEmail`
         # @return [String]
         attr_accessor :gmb_email
       
-        # Status of the link between this Merchant Center account and the GMB account.
-        # Acceptable values are: - "`active`" - "`pending`"
+        # Status of the link between this Merchant Center account and the Business
+        # Profile. Acceptable values are: - "`active`" - "`pending`"
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
@@ -3478,7 +3479,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :account_id
       
-        # A list of GMB accounts which are available to the merchant.
+        # A list of Business Profiles which are available to the merchant.
         # Corresponds to the JSON property `gmbAccounts`
         # @return [Array<Google::Apis::ContentV2_1::GmbAccountsGmbAccount>]
         attr_accessor :gmb_accounts
@@ -3498,7 +3499,7 @@ module Google
       class GmbAccountsGmbAccount
         include Google::Apis::Core::Hashable
       
-        # The email which identifies the GMB account.
+        # The email which identifies the Business Profile.
         # Corresponds to the JSON property `email`
         # @return [String]
         attr_accessor :email
@@ -3508,12 +3509,12 @@ module Google
         # @return [Fixnum]
         attr_accessor :listing_count
       
-        # The name of the GMB account.
+        # The name of the Business Profile.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The type of the GMB account (User or Business).
+        # The type of the Business Profile (User or Business).
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -4074,7 +4075,7 @@ module Google
         # @return [String]
         attr_accessor :country
       
-        # The GMB account. Required only for RequestGmbAccess.
+        # The Business Profile. Required only for RequestGmbAccess.
         # Corresponds to the JSON property `gmbEmail`
         # @return [String]
         attr_accessor :gmb_email
@@ -4168,7 +4169,7 @@ module Google
         # @return [Google::Apis::ContentV2_1::Errors]
         attr_accessor :errors
       
-        # The list of accessible GMB accounts.
+        # The list of accessible Business Profiles.
         # Corresponds to the JSON property `gmbAccounts`
         # @return [Google::Apis::ContentV2_1::GmbAccounts]
         attr_accessor :gmb_accounts
@@ -4214,7 +4215,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :account_id
       
-        # A list of GMB accounts which are available to the merchant.
+        # A list of Business Profiles which are available to the merchant.
         # Corresponds to the JSON property `gmbAccounts`
         # @return [Array<Google::Apis::ContentV2_1::GmbAccountsGmbAccount>]
         attr_accessor :gmb_accounts
@@ -6952,6 +6953,11 @@ module Google
       class OrderTrackingSignalLineItemDetails
         include Google::Apis::Core::Hashable
       
+        # Brand of the product.
+        # Corresponds to the JSON property `brand`
+        # @return [String]
+        attr_accessor :brand
+      
         # The Global Trade Item Number.
         # Corresponds to the JSON property `gtin`
         # @return [String]
@@ -6967,7 +6973,8 @@ module Google
         # @return [String]
         attr_accessor :mpn
       
-        # Plain text description of this product.
+        # Plain text description of this product (deprecated: Please use product_title
+        # instead).
         # Corresponds to the JSON property `productDescription`
         # @return [String]
         attr_accessor :product_description
@@ -6978,17 +6985,22 @@ module Google
         # @return [String]
         attr_accessor :product_id
       
-        # Required. The quantity of the line item in the order.
+        # Plain text title of this product.
+        # Corresponds to the JSON property `productTitle`
+        # @return [String]
+        attr_accessor :product_title
+      
+        # The quantity of the line item in the order.
         # Corresponds to the JSON property `quantity`
         # @return [Fixnum]
         attr_accessor :quantity
       
-        # Merchant SKU for this item.
+        # Merchant SKU for this item (deprecated).
         # Corresponds to the JSON property `sku`
         # @return [String]
         attr_accessor :sku
       
-        # Universal product code for this item.
+        # Universal product code for this item (deprecated: Please use GTIN instead).
         # Corresponds to the JSON property `upc`
         # @return [String]
         attr_accessor :upc
@@ -6999,11 +7011,13 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @brand = args[:brand] if args.key?(:brand)
           @gtin = args[:gtin] if args.key?(:gtin)
           @line_item_id = args[:line_item_id] if args.key?(:line_item_id)
           @mpn = args[:mpn] if args.key?(:mpn)
           @product_description = args[:product_description] if args.key?(:product_description)
           @product_id = args[:product_id] if args.key?(:product_id)
+          @product_title = args[:product_title] if args.key?(:product_title)
           @quantity = args[:quantity] if args.key?(:quantity)
           @sku = args[:sku] if args.key?(:sku)
           @upc = args[:upc] if args.key?(:upc)
@@ -7020,7 +7034,7 @@ module Google
         # @return [String]
         attr_accessor :line_item_id
       
-        # Required. The line item quantity in the shipment.
+        # The line item quantity in the shipment.
         # Corresponds to the JSON property `quantity`
         # @return [Fixnum]
         attr_accessor :quantity
@@ -9584,7 +9598,7 @@ module Google
         attr_accessor :quantity
       
         # Required. The identifier of the merchant's store. Either a `storeCode`
-        # inserted via the API or the code of the store in Google My Business.
+        # inserted via the API or the code of the store in a Business Profile.
         # Corresponds to the JSON property `storeCode`
         # @return [String]
         attr_accessor :store_code
@@ -9647,7 +9661,7 @@ module Google
         attr_accessor :quantity
       
         # Required. The identifier of the merchant's store. Either a `storeCode`
-        # inserted via the API or the code of the store in Google My Business.
+        # inserted via the API or the code of the store in a Business Profile.
         # Corresponds to the JSON property `storeCode`
         # @return [String]
         attr_accessor :store_code
@@ -9715,7 +9729,7 @@ module Google
         attr_accessor :quantity
       
         # Required. The identifier of the merchant's store. Either a `storeCode`
-        # inserted via the API or the code of the store in Google My Business.
+        # inserted via the API or the code of the store in a Business Profile.
         # Corresponds to the JSON property `storeCode`
         # @return [String]
         attr_accessor :store_code
@@ -9816,7 +9830,7 @@ module Google
         attr_accessor :sale_id
       
         # Required. The identifier of the merchant's store. Either a `storeCode`
-        # inserted via the API or the code of the store in Google My Business.
+        # inserted via the API or the code of the store in a Business Profile.
         # Corresponds to the JSON property `storeCode`
         # @return [String]
         attr_accessor :store_code
@@ -9886,7 +9900,7 @@ module Google
         attr_accessor :sale_id
       
         # Required. The identifier of the merchant's store. Either a `storeCode`
-        # inserted via the API or the code of the store in Google My Business.
+        # inserted via the API or the code of the store in a Business Profile.
         # Corresponds to the JSON property `storeCode`
         # @return [String]
         attr_accessor :store_code
@@ -9961,7 +9975,7 @@ module Google
         attr_accessor :sale_id
       
         # Required. The identifier of the merchant's store. Either a `storeCode`
-        # inserted via the API or the code of the store in Google My Business.
+        # inserted via the API or the code of the store in a Business Profile.
         # Corresponds to the JSON property `storeCode`
         # @return [String]
         attr_accessor :store_code
@@ -11724,7 +11738,7 @@ module Google
         # promotion. Content API methods that operate on promotions take this as their
         # promotionId parameter. The REST ID for a promotion is of the form channel:
         # contentLanguage:targetCountry:promotionId The channel field will have a value
-        # of "online", "local", or "onlinelocal".
+        # of "online", "in_store", or "online_in_store".
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
@@ -11825,11 +11839,21 @@ module Google
         # @return [String]
         attr_accessor :promotion_display_dates
       
+        # A message that represents a time period.
+        # Corresponds to the JSON property `promotionDisplayTimePeriod`
+        # @return [Google::Apis::ContentV2_1::TimePeriod]
+        attr_accessor :promotion_display_time_period
+      
         # Required. String representation of the promotion effective dates.
         # Corresponds to the JSON property `promotionEffectiveDates`
         # @return [String]
         attr_accessor :promotion_effective_dates
       
+        # A message that represents a time period.
+        # Corresponds to the JSON property `promotionEffectiveTimePeriod`
+        # @return [Google::Apis::ContentV2_1::TimePeriod]
+        attr_accessor :promotion_effective_time_period
+      
         # Required. The user provided promotion id to uniquely identify the promotion.
         # Corresponds to the JSON property `promotionId`
         # @return [String]
@@ -11886,7 +11910,9 @@ module Google
           @product_type_exclusion = args[:product_type_exclusion] if args.key?(:product_type_exclusion)
           @promotion_destination_ids = args[:promotion_destination_ids] if args.key?(:promotion_destination_ids)
           @promotion_display_dates = args[:promotion_display_dates] if args.key?(:promotion_display_dates)
+          @promotion_display_time_period = args[:promotion_display_time_period] if args.key?(:promotion_display_time_period)
           @promotion_effective_dates = args[:promotion_effective_dates] if args.key?(:promotion_effective_dates)
+          @promotion_effective_time_period = args[:promotion_effective_time_period] if args.key?(:promotion_effective_time_period)
           @promotion_id = args[:promotion_id] if args.key?(:promotion_id)
           @redemption_channel = args[:redemption_channel] if args.key?(:redemption_channel)
           @shipping_service_names = args[:shipping_service_names] if args.key?(:shipping_service_names)
@@ -15567,6 +15593,31 @@ module Google
         end
       end
       
+      # A message that represents a time period.
+      class TimePeriod
+        include Google::Apis::Core::Hashable
+      
+        # The ending timestamp.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # The starting timestamp.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @start_time = args[:start_time] if args.key?(:start_time)
+        end
+      end
+      
       # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/
       # time-zones).
       class TimeZone

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module ContentV2_1
       # Version of the google-apis-content_v2_1 gem
-      GEM_VERSION = "0.24.0"
+      GEM_VERSION = "0.28.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.4.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20211007"
+      REVISION = "20211126"
     end
   end
 end

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

@@ -2242,6 +2242,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class TimePeriod
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class TimeZone
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -4202,11 +4208,13 @@ module Google
       class OrderTrackingSignalLineItemDetails
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :brand, as: 'brand'
           property :gtin, as: 'gtin'
           property :line_item_id, as: 'lineItemId'
           property :mpn, as: 'mpn'
           property :product_description, as: 'productDescription'
           property :product_id, as: 'productId'
+          property :product_title, as: 'productTitle'
           property :quantity, :numeric_string => true, as: 'quantity'
           property :sku, as: 'sku'
           property :upc, as: 'upc'
@@ -5483,7 +5491,11 @@ module Google
           collection :product_type_exclusion, as: 'productTypeExclusion'
           collection :promotion_destination_ids, as: 'promotionDestinationIds'
           property :promotion_display_dates, as: 'promotionDisplayDates'
+          property :promotion_display_time_period, as: 'promotionDisplayTimePeriod', class: Google::Apis::ContentV2_1::TimePeriod, decorator: Google::Apis::ContentV2_1::TimePeriod::Representation
+      
           property :promotion_effective_dates, as: 'promotionEffectiveDates'
+          property :promotion_effective_time_period, as: 'promotionEffectiveTimePeriod', class: Google::Apis::ContentV2_1::TimePeriod, decorator: Google::Apis::ContentV2_1::TimePeriod::Representation
+      
           property :promotion_id, as: 'promotionId'
           collection :redemption_channel, as: 'redemptionChannel'
           collection :shipping_service_names, as: 'shippingServiceNames'
@@ -6497,6 +6509,14 @@ module Google
         end
       end
       
+      class TimePeriod
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :end_time, as: 'endTime'
+          property :start_time, as: 'startTime'
+        end
+      end
+      
       class TimeZone
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -2141,14 +2141,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of accessible Google My Business accounts.
+        # Retrieves the list of accessible Business Profiles.
         # @param [Fixnum] merchant_id
         #   The ID of the managing account. If this parameter is not the same as accountId,
         #   then this account must be a multi-client account and `accountId` must be the
         #   ID of a sub-account of this account.
         # @param [Fixnum] account_id
-        #   The ID of the account for which to retrieve accessible Google My Business
-        #   accounts.
+        #   The ID of the account for which to retrieve accessible Business Profiles.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2241,15 +2240,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Requests access to a specified Google My Business account.
+        # Requests access to a specified Business Profile.
         # @param [Fixnum] merchant_id
         #   The ID of the managing account. If this parameter is not the same as accountId,
         #   then this account must be a multi-client account and `accountId` must be the
         #   ID of a sub-account of this account.
         # @param [Fixnum] account_id
-        #   The ID of the account for which GMB access is requested.
+        #   The ID of the account for which Business Profile access is requested.
         # @param [String] gmb_email
-        #   The email of the Google My Business account.
+        #   The email of the Business Profile.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2372,8 +2371,7 @@ module Google
         #   then this account must be a multi-client account and `accountId` must be the
         #   ID of a sub-account of this account.
         # @param [Fixnum] account_id
-        #   The ID of the account for which to retrieve accessible Google My Business
-        #   accounts.
+        #   The ID of the account for which to retrieve accessible Business Profiles.
         # @param [String] country
         #   The country for which the POS data provider is selected.
         # @param [Fixnum] pos_data_provider_id
@@ -4517,6 +4515,39 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Retrieves a promotion from your Merchant Center account.
+        # @param [Fixnum] merchant_id
+        #   Required. The ID of the account that contains the collection.
+        # @param [String] id
+        #   Required. REST ID of the promotion to retrieve.
+        # @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::ContentV2_1::Promotion] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ContentV2_1::Promotion]
+        #
+        # @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_promotion(merchant_id, id, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, '{merchantId}/promotions/{id}', options)
+          command.response_representation = Google::Apis::ContentV2_1::Promotion::Representation
+          command.response_class = Google::Apis::ContentV2_1::Promotion
+          command.params['merchantId'] = merchant_id unless merchant_id.nil?
+          command.params['id'] = id unless id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Retrieves a Merchant Center account's pubsub notification settings.
         # @param [Fixnum] merchant_id
         #   The ID of the account for which to get pubsub notification settings.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-content_v2_1
 version: !ruby/object:Gem::Version
-  version: 0.24.0
+  version: 0.28.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-10-18 00:00:00.000000000 Z
+date: 2022-01-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -57,9 +57,9 @@ licenses:
 - Apache-2.0
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
-  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-content_v2_1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-content_v2_1/v0.24.0
-  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-content_v2_1
+  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-content_v2_1/CHANGELOG.md
+  documentation_uri: https://googleapis.dev/ruby/google-apis-content_v2_1/v0.28.0
+  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-content_v2_1
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.17
+rubygems_version: 3.3.4
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Content API for Shopping V2_1