google-apis-retail_v2 0.32.0 → 0.35.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 233478bb57c972e6f2f535ddfbcee72ebfc4052f5de8d79afc73db1f26b3cb15
-  data.tar.gz: 63088218281dafba204bea53192f5b6d10982c22b2a07c0f84c405dc9a12bc60
+  metadata.gz: 530f53f799eda6665eb83ac1b7e46cad9132092a5beaf31a8efd981ca78d55e0
+  data.tar.gz: 0d5c6a488b5f2e3c9bafec0af8a1e72075aa0cb098b7597a40f5ab7000522891
 SHA512:
-  metadata.gz: 035f15cd06ef6bacb052c352f15e427d4372dbe9d6f8e90c2276062716a6827418932d86839d47359eeeb09b7dc165da57b49e806ca72ba18687e7557acbe0c1
-  data.tar.gz: 1269c8a22f73067dc09a72cbc04b3af2432874caa37c9471c97f2cc7ecfe869e620cb1db15ea0e08f2e94f6df34965b8112969e23bcda0d6f6ce6e1863c960ed
+  metadata.gz: 1f3e416aaf3950c7426053919eb5c9bd38622a339992059bd058e897007d714e2ba8ec91b0acc64310ac3ec311e8944afa82852ae7d3e0557162dc31fc179c35
+  data.tar.gz: 78d37620b41ee26b09aaf923fba197ebde44380e26853e939d9759009732d9cc2d17cda1b2150ac037b8f41e43b040a1379b46ea9101d8dd9bfd8d804e9d595b

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Release history for google-apis-retail_v2
 
+### v0.35.0 (2022-04-22)
+
+* Regenerated from discovery document revision 20220414
+
+### v0.34.0 (2022-04-14)
+
+* Regenerated from discovery document revision 20220408
+
+### v0.33.0 (2022-03-31)
+
+* Regenerated from discovery document revision 20220324
+
 ### v0.32.0 (2022-03-24)
 
 * Regenerated from discovery document revision 20220319

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

@@ -364,6 +364,86 @@ module Google
         end
       end
       
+      # Metadata related to the progress of the AddLocalInventories operation.
+      # Currently empty because there is no meaningful metadata populated from the
+      # AddLocalInventories method.
+      class GoogleCloudRetailV2AddLocalInventoriesMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Request message for AddLocalInventories method.
+      class GoogleCloudRetailV2AddLocalInventoriesRequest
+        include Google::Apis::Core::Hashable
+      
+        # Indicates which inventory fields in the provided list of LocalInventory to
+        # update. The field is updated to the provided value. If a field is set while
+        # the place does not have a previous local inventory, the local inventory at
+        # that store is created. If a field is set while the value of that field is not
+        # provided, the original field value, if it exists, is deleted. If the mask is
+        # not set or set with empty paths, all inventory fields will be updated. If an
+        # unsupported or unknown field is provided, an INVALID_ARGUMENT error is
+        # returned and the entire update will be ignored.
+        # Corresponds to the JSON property `addMask`
+        # @return [String]
+        attr_accessor :add_mask
+      
+        # The time when the inventory updates are issued. Used to prevent out-of-order
+        # updates on local inventory fields. If not provided, the internal system time
+        # will be used.
+        # Corresponds to the JSON property `addTime`
+        # @return [String]
+        attr_accessor :add_time
+      
+        # If set to true, and the Product is not found, the local inventory will still
+        # be processed and retained for at most 1 day and processed once the Product is
+        # created. If set to false, a NOT_FOUND error is returned if the Product is not
+        # found.
+        # Corresponds to the JSON property `allowMissing`
+        # @return [Boolean]
+        attr_accessor :allow_missing
+        alias_method :allow_missing?, :allow_missing
+      
+        # Required. A list of inventory information at difference places. Each place is
+        # identified by its place ID. At most 3000 inventories are allowed per request.
+        # Corresponds to the JSON property `localInventories`
+        # @return [Array<Google::Apis::RetailV2::GoogleCloudRetailV2LocalInventory>]
+        attr_accessor :local_inventories
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @add_mask = args[:add_mask] if args.key?(:add_mask)
+          @add_time = args[:add_time] if args.key?(:add_time)
+          @allow_missing = args[:allow_missing] if args.key?(:allow_missing)
+          @local_inventories = args[:local_inventories] if args.key?(:local_inventories)
+        end
+      end
+      
+      # Response of the AddLocalInventories API. Currently empty because there is no
+      # meaningful response populated from the AddLocalInventories method.
+      class GoogleCloudRetailV2AddLocalInventoriesResponse
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # An intended audience of the Product for whom it's sold.
       class GoogleCloudRetailV2Audience
         include Google::Apis::Core::Hashable
@@ -1029,11 +1109,15 @@ module Google
         # @return [Google::Apis::RetailV2::GoogleCloudRetailV2ProductInputConfig]
         attr_accessor :input_config
       
-        # Pub/Sub topic for receiving notification. If this field is set, when the
-        # import is finished, a notification will be sent to specified Pub/Sub topic.
+        # Full Pub/Sub topic name for receiving notification. If this field is set, when
+        # the import is finished, a notification will be sent to specified Pub/Sub topic.
         # The message data will be JSON string of a Operation. Format of the Pub/Sub
-        # topic is `projects/`project`/topics/`topic``. Only supported when
-        # ImportProductsRequest.reconciliation_mode is set to `FULL`.
+        # topic is `projects/`project`/topics/`topic``. It has to be within the same
+        # project as ImportProductsRequest.parent. Make sure that both `cloud-retail-
+        # customer-data-access@system.gserviceaccount.com` and `service-@gcp-sa-retail.
+        # iam.gserviceaccount.com` have the `pubsub.topics.publish` IAM permission on
+        # the topic. Only supported when ImportProductsRequest.reconciliation_mode is
+        # set to `FULL`.
         # Corresponds to the JSON property `notificationPubsubTopic`
         # @return [String]
         attr_accessor :notification_pubsub_topic
@@ -1245,6 +1329,59 @@ module Google
         end
       end
       
+      # The inventory information at a place (e.g. a store) identified by a place ID.
+      class GoogleCloudRetailV2LocalInventory
+        include Google::Apis::Core::Hashable
+      
+        # Additional local inventory attributes, for example, store name, promotion tags,
+        # etc. This field needs to pass all below criteria, otherwise an
+        # INVALID_ARGUMENT error is returned: * At most 30 attributes are allowed. * The
+        # key must be a UTF-8 encoded string with a length limit of 32 characters. * The
+        # key must match the pattern: `a-zA-Z0-9*`. For example, key0LikeThis or
+        # KEY_1_LIKE_THIS. * The attribute values must be of the same type (text or
+        # number). * Only 1 value is allowed for each attribute. * For text values, the
+        # length limit is 256 UTF-8 characters. * The attribute does not support search.
+        # The `searchable` field should be unset or set to false. * The max summed total
+        # bytes of custom attribute keys and values per product is 5MiB.
+        # Corresponds to the JSON property `attributes`
+        # @return [Hash<String,Google::Apis::RetailV2::GoogleCloudRetailV2CustomAttribute>]
+        attr_accessor :attributes
+      
+        # Input only. Supported fulfillment types. Valid fulfillment type values include
+        # commonly used types (such as pickup in store and same day delivery), and
+        # custom types. Customers have to map custom types to their display names before
+        # rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-
+        # day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "
+        # custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an
+        # invalid value other than these, an INVALID_ARGUMENT error is returned. All the
+        # elements must be distinct. Otherwise, an INVALID_ARGUMENT error is returned.
+        # Corresponds to the JSON property `fulfillmentTypes`
+        # @return [Array<String>]
+        attr_accessor :fulfillment_types
+      
+        # The place ID for the current set of inventory information.
+        # Corresponds to the JSON property `placeId`
+        # @return [String]
+        attr_accessor :place_id
+      
+        # The price information of a Product.
+        # Corresponds to the JSON property `priceInfo`
+        # @return [Google::Apis::RetailV2::GoogleCloudRetailV2PriceInfo]
+        attr_accessor :price_info
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @attributes = args[:attributes] if args.key?(:attributes)
+          @fulfillment_types = args[:fulfillment_types] if args.key?(:fulfillment_types)
+          @place_id = args[:place_id] if args.key?(:place_id)
+          @price_info = args[:price_info] if args.key?(:price_info)
+        end
+      end
+      
       # Request message for Predict method.
       class GoogleCloudRetailV2PredictRequest
         include Google::Apis::Core::Hashable
@@ -1440,7 +1577,8 @@ module Google
         attr_accessor :currency_code
       
         # Price of the product without any discount. If zero, by default set to be the
-        # price.
+        # price. If set, original_price should be greater than or equal to price,
+        # otherwise an INVALID_ARGUMENT error is thrown.
         # Corresponds to the JSON property `originalPrice`
         # @return [Float]
         attr_accessor :original_price
@@ -1976,13 +2114,13 @@ module Google
         # The type of Products allowed to be ingested into the catalog. Acceptable
         # values are: * `primary` (default): You can ingest Products of all types. When
         # ingesting a Product, its type will default to Product.Type.PRIMARY if unset. *
-        # `variant`: You can only ingest Product.Type.VARIANT Products. This means
-        # Product.primary_product_id cannot be empty. If this field is set to an invalid
-        # value other than these, an INVALID_ARGUMENT error is returned. If this field
-        # is `variant` and merchant_center_product_id_field is `itemGroupId`, an
-        # INVALID_ARGUMENT error is returned. See [Using product levels](https://cloud.
-        # google.com/retail/recommendations-ai/docs/catalog#product-levels) for more
-        # details.
+        # `variant` (incompatible with Retail Search): You can only ingest Product.Type.
+        # VARIANT Products. This means Product.primary_product_id cannot be empty. If
+        # this field is set to an invalid value other than these, an INVALID_ARGUMENT
+        # error is returned. If this field is `variant` and
+        # merchant_center_product_id_field is `itemGroupId`, an INVALID_ARGUMENT error
+        # is returned. See [Product levels](https://cloud.google.com/retail/docs/catalog#
+        # product-levels) for more details.
         # Corresponds to the JSON property `ingestionProductType`
         # @return [String]
         attr_accessor :ingestion_product_type
@@ -1995,8 +2133,8 @@ module Google
         # the item group. If this field is set to an invalid value other than these, an
         # INVALID_ARGUMENT error is returned. If this field is `itemGroupId` and
         # ingestion_product_type is `variant`, an INVALID_ARGUMENT error is returned.
-        # See [Using product levels](https://cloud.google.com/retail/recommendations-ai/
-        # docs/catalog#product-levels) for more details.
+        # See [Product levels](https://cloud.google.com/retail/docs/catalog#product-
+        # levels) for more details.
         # Corresponds to the JSON property `merchantCenterProductIdField`
         # @return [String]
         attr_accessor :merchant_center_product_id_field
@@ -2330,6 +2468,73 @@ module Google
         end
       end
       
+      # Metadata related to the progress of the RemoveLocalInventories operation.
+      # Currently empty because there is no meaningful metadata populated from the
+      # RemoveLocalInventories method.
+      class GoogleCloudRetailV2RemoveLocalInventoriesMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Request message for RemoveLocalInventories method.
+      class GoogleCloudRetailV2RemoveLocalInventoriesRequest
+        include Google::Apis::Core::Hashable
+      
+        # If set to true, and the Product is not found, the local inventory removal
+        # request will still be processed and retained for at most 1 day and processed
+        # once the Product is created. If set to false, a NOT_FOUND error is returned if
+        # the Product is not found.
+        # Corresponds to the JSON property `allowMissing`
+        # @return [Boolean]
+        attr_accessor :allow_missing
+        alias_method :allow_missing?, :allow_missing
+      
+        # Required. A list of place IDs to have their inventory deleted. At most 3000
+        # place IDs are allowed per request.
+        # Corresponds to the JSON property `placeIds`
+        # @return [Array<String>]
+        attr_accessor :place_ids
+      
+        # The time when the inventory deletions are issued. Used to prevent out-of-order
+        # updates and deletions on local inventory fields. If not provided, the internal
+        # system time will be used.
+        # Corresponds to the JSON property `removeTime`
+        # @return [String]
+        attr_accessor :remove_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @allow_missing = args[:allow_missing] if args.key?(:allow_missing)
+          @place_ids = args[:place_ids] if args.key?(:place_ids)
+          @remove_time = args[:remove_time] if args.key?(:remove_time)
+        end
+      end
+      
+      # Response of the RemoveLocalInventories API. Currently empty because there is
+      # no meaningful response populated from the RemoveLocalInventories method.
+      class GoogleCloudRetailV2RemoveLocalInventoriesResponse
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Request message for SearchService.Search method.
       class GoogleCloudRetailV2SearchRequest
         include Google::Apis::Core::Hashable
@@ -2378,6 +2583,21 @@ module Google
         # @return [String]
         attr_accessor :filter
       
+        # The labels applied to a resource must meet the following requirements: * Each
+        # resource can have multiple labels, up to a maximum of 64. * Each label must be
+        # a key-value pair. * Keys have a minimum length of 1 character and a maximum
+        # length of 63 characters, and cannot be empty. Values can be empty, and have a
+        # maximum length of 63 characters. * Keys and values can contain only lowercase
+        # letters, numeric characters, underscores, and dashes. All characters must use
+        # UTF-8 encoding, and international characters are allowed. * The key portion of
+        # a label must be unique. However, you can use the same key with multiple
+        # resources. * Keys must start with a lowercase letter or international
+        # character. See [Google Cloud Document](https://cloud.google.com/resource-
+        # manager/docs/creating-managing-labels#requirements) for more details.
+        # Corresponds to the JSON property `labels`
+        # @return [Hash<String,String>]
+        attr_accessor :labels
+      
         # A 0-indexed integer that specifies the current offset (that is, starting
         # result location, amongst the Products deemed by the API as relevant) in search
         # results. This field is only considered if page_token is unset. If this field
@@ -2427,7 +2647,8 @@ module Google
         # @return [Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestPersonalizationSpec]
         attr_accessor :personalization_spec
       
-        # Raw search query.
+        # Raw search query. If this field is empty, the request is considered a category
+        # browsing request and returned results are based on filter and page_categories.
         # Corresponds to the JSON property `query`
         # @return [String]
         attr_accessor :query
@@ -2500,6 +2721,7 @@ module Google
           @dynamic_facet_spec = args[:dynamic_facet_spec] if args.key?(:dynamic_facet_spec)
           @facet_specs = args[:facet_specs] if args.key?(:facet_specs)
           @filter = args[:filter] if args.key?(:filter)
+          @labels = args[:labels] if args.key?(:labels)
           @offset = args[:offset] if args.key?(:offset)
           @order_by = args[:order_by] if args.key?(:order_by)
           @page_categories = args[:page_categories] if args.key?(:page_categories)
@@ -3347,10 +3569,12 @@ module Google
         # Required. A unique identifier for tracking visitors. For example, this could
         # be implemented with an HTTP cookie, which should be able to uniquely identify
         # a visitor on a single device. This unique identifier should not change if the
-        # visitor log in/out of the website. The field must be a UTF-8 encoded string
-        # with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is
-        # returned. The field should not contain PII or user-data. We recommend to use
-        # Google Analystics [Client ID](https://developers.google.com/analytics/
+        # visitor log in/out of the website. Don't set the field to the same fixed ID
+        # for different users. This mixes the event history of those users together,
+        # which results in degraded model quality. The field must be a UTF-8 encoded
+        # string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT
+        # error is returned. The field should not contain PII or user-data. We recommend
+        # to use Google Analystics [Client ID](https://developers.google.com/analytics/
         # devguides/collection/analyticsjs/field-reference#clientId) for this field.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
@@ -3477,13 +3701,12 @@ module Google
         attr_accessor :direct_user_request
         alias_method :direct_user_request?, :direct_user_request
       
-        # The end user's IP address. Required for getting SearchResponse.
-        # sponsored_results. This field is used to extract location information for
-        # personalization. This field must be either an IPv4 address (e.g. "104.133.9.80"
-        # ) or an IPv6 address (e.g. "2001:0db8:85a3:0000:0000:8a2e:0370:7334").
-        # Otherwise, an INVALID_ARGUMENT error is returned. This should not be set when
-        # using the JavaScript tag in UserEventService.CollectUserEvent or if
-        # direct_user_request is set.
+        # The end user's IP address. This field is used to extract location information
+        # for personalization. This field must be either an IPv4 address (e.g. "104.133.
+        # 9.80") or an IPv6 address (e.g. "2001:0db8:85a3:0000:0000:8a2e:0370:7334").
+        # Otherwise, an INVALID_ARGUMENT error is returned. This should not be set when:
+        # * setting SearchRequest.user_info. * using the JavaScript tag in
+        # UserEventService.CollectUserEvent or if direct_user_request is set.
         # Corresponds to the JSON property `ipAddress`
         # @return [String]
         attr_accessor :ip_address
@@ -3499,7 +3722,10 @@ module Google
         attr_accessor :user_agent
       
         # Highly recommended for logged-in users. Unique identifier for logged-in user,
-        # such as a user name. The field must be a UTF-8 encoded string with a length
+        # such as a user name. Don't set for anonymous users. Always use a hashed value
+        # for this ID. Don't set the field to the same fixed ID for different users.
+        # This mixes the event history of those users together, which results in
+        # degraded model quality. The field must be a UTF-8 encoded string with a length
         # limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.
         # Corresponds to the JSON property `userId`
         # @return [String]
@@ -4113,6 +4339,35 @@ module Google
         end
       end
       
+      # Metadata related to the progress of the AddLocalInventories operation.
+      # Currently empty because there is no meaningful metadata populated from the
+      # AddLocalInventories method.
+      class GoogleCloudRetailV2betaAddLocalInventoriesMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Response of the AddLocalInventories API. Currently empty because there is no
+      # meaningful response populated from the AddLocalInventories method.
+      class GoogleCloudRetailV2betaAddLocalInventoriesResponse
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Configuration of destination for Export related errors.
       class GoogleCloudRetailV2betaExportErrorsConfig
         include Google::Apis::Core::Hashable
@@ -4468,6 +4723,35 @@ module Google
         end
       end
       
+      # Metadata related to the progress of the RemoveLocalInventories operation.
+      # Currently empty because there is no meaningful metadata populated from the
+      # RemoveLocalInventories method.
+      class GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Response of the RemoveLocalInventories API. Currently empty because there is
+      # no meaningful response populated from the RemoveLocalInventories method.
+      class GoogleCloudRetailV2betaRemoveLocalInventoriesResponse
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Metadata related to the progress of the SetInventory operation. Currently
       # empty because there is no meaningful metadata populated from the SetInventory
       # method.

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module RetailV2
       # Version of the google-apis-retail_v2 gem
-      GEM_VERSION = "0.32.0"
+      GEM_VERSION = "0.35.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.4.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20220319"
+      REVISION = "20220414"
     end
   end
 end

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

@@ -82,6 +82,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2AddLocalInventoriesMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2AddLocalInventoriesRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2AddLocalInventoriesResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2Audience
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -232,6 +250,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2LocalInventory
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2PredictRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -364,6 +388,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2RemoveLocalInventoriesMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2RemoveLocalInventoriesRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2RemoveLocalInventoriesResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2SearchRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -664,6 +706,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2betaAddLocalInventoriesMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2betaAddLocalInventoriesResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2betaExportErrorsConfig
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -754,6 +808,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudRetailV2betaRemoveLocalInventoriesResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudRetailV2betaSetInventoryMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -893,6 +959,29 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2AddLocalInventoriesMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class GoogleCloudRetailV2AddLocalInventoriesRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :add_mask, as: 'addMask'
+          property :add_time, as: 'addTime'
+          property :allow_missing, as: 'allowMissing'
+          collection :local_inventories, as: 'localInventories', class: Google::Apis::RetailV2::GoogleCloudRetailV2LocalInventory, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2LocalInventory::Representation
+      
+        end
+      end
+      
+      class GoogleCloudRetailV2AddLocalInventoriesResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class GoogleCloudRetailV2Audience
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1130,6 +1219,18 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2LocalInventory
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :attributes, as: 'attributes', class: Google::Apis::RetailV2::GoogleCloudRetailV2CustomAttribute, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2CustomAttribute::Representation
+      
+          collection :fulfillment_types, as: 'fulfillmentTypes'
+          property :place_id, as: 'placeId'
+          property :price_info, as: 'priceInfo', class: Google::Apis::RetailV2::GoogleCloudRetailV2PriceInfo, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2PriceInfo::Representation
+      
+        end
+      end
+      
       class GoogleCloudRetailV2PredictRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1362,6 +1463,27 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2RemoveLocalInventoriesMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class GoogleCloudRetailV2RemoveLocalInventoriesRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :allow_missing, as: 'allowMissing'
+          collection :place_ids, as: 'placeIds'
+          property :remove_time, as: 'removeTime'
+        end
+      end
+      
+      class GoogleCloudRetailV2RemoveLocalInventoriesResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class GoogleCloudRetailV2SearchRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1374,6 +1496,7 @@ module Google
           collection :facet_specs, as: 'facetSpecs', class: Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestFacetSpec, decorator: Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequestFacetSpec::Representation
       
           property :filter, as: 'filter'
+          hash :labels, as: 'labels'
           property :offset, as: 'offset'
           property :order_by, as: 'orderBy'
           collection :page_categories, as: 'pageCategories'
@@ -1825,6 +1948,18 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2betaAddLocalInventoriesMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class GoogleCloudRetailV2betaAddLocalInventoriesResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class GoogleCloudRetailV2betaExportErrorsConfig
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1947,6 +2082,18 @@ module Google
         end
       end
       
+      class GoogleCloudRetailV2betaRemoveLocalInventoriesMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class GoogleCloudRetailV2betaRemoveLocalInventoriesResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class GoogleCloudRetailV2betaSetInventoryMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -52,9 +52,8 @@ module Google
         end
         
         # Completes the specified prefix with keyword suggestions. This feature is only
-        # available for users who have Retail Search enabled. Please submit a form [here]
-        # (https://cloud.google.com/contact) to contact cloud sales if you are
-        # interested in using Retail Search.
+        # available for users who have Retail Search enabled. Please enable Retail
+        # Search on Cloud Console before using this feature.
         # @param [String] catalog
         #   Required. Catalog for which the completion is performed. Full resource name of
         #   catalog, such as `projects/*/locations/global/catalogs/default_catalog`.
@@ -326,9 +325,8 @@ module Google
         # enqueued and processed downstream. As a consequence, when a response is
         # returned, the added place IDs are not immediately manifested in the Product
         # queried by GetProduct or ListProducts. This feature is only available for
-        # users who have Retail Search enabled. Please submit a form [here](https://
-        # cloud.google.com/contact) to contact cloud sales if you are interested in
-        # using Retail Search.
+        # users who have Retail Search enabled. Please enable Retail Search on Cloud
+        # Console before using this feature.
         # @param [String] product
         #   Required. Full resource name of Product, such as `projects/*/locations/global/
         #   catalogs/default_catalog/branches/default_branch/products/some_product_id`. If
@@ -364,6 +362,51 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Updates local inventory information for a Product at a list of places, while
+        # respecting the last update timestamps of each inventory field. This process is
+        # asynchronous and does not require the Product to exist before updating
+        # inventory information. If the request is valid, the update will be enqueued
+        # and processed downstream. As a consequence, when a response is returned,
+        # updates are not immediately manifested in the Product queried by GetProduct or
+        # ListProducts. Local inventory information can only be modified using this
+        # method. CreateProduct and UpdateProduct has no effect on local inventories.
+        # This feature is only available for users who have Retail Search enabled.
+        # Please enable Retail Search on Cloud Console before using this feature.
+        # @param [String] product
+        #   Required. Full resource name of Product, such as `projects/*/locations/global/
+        #   catalogs/default_catalog/branches/default_branch/products/some_product_id`. If
+        #   the caller does not have permission to access the Product, regardless of
+        #   whether or not it exists, a PERMISSION_DENIED error is returned.
+        # @param [Google::Apis::RetailV2::GoogleCloudRetailV2AddLocalInventoriesRequest] google_cloud_retail_v2_add_local_inventories_request_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::RetailV2::GoogleLongrunningOperation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RetailV2::GoogleLongrunningOperation]
+        #
+        # @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 add_project_location_catalog_branch_product_local_inventories(product, google_cloud_retail_v2_add_local_inventories_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v2/{+product}:addLocalInventories', options)
+          command.request_representation = Google::Apis::RetailV2::GoogleCloudRetailV2AddLocalInventoriesRequest::Representation
+          command.request_object = google_cloud_retail_v2_add_local_inventories_request_object
+          command.response_representation = Google::Apis::RetailV2::GoogleLongrunningOperation::Representation
+          command.response_class = Google::Apis::RetailV2::GoogleLongrunningOperation
+          command.params['product'] = product unless product.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Creates a Product.
         # @param [String] parent
         #   Required. The parent catalog resource name, such as `projects/*/locations/
@@ -595,7 +638,9 @@ module Google
         #   output only fields are NOT supported. If not set, all supported fields (the
         #   fields that are neither immutable nor output only) are updated. If an
         #   unsupported or unknown field is provided, an INVALID_ARGUMENT error is
-        #   returned.
+        #   returned. The attribute key can be updated by setting the mask path as "
+        #   attributes.$`key_name`". If a key name is present in the mask but not in the
+        #   patching product from the request, this key will be deleted after the update.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -633,9 +678,8 @@ module Google
         # enqueued and processed downstream. As a consequence, when a response is
         # returned, the removed place IDs are not immediately manifested in the Product
         # queried by GetProduct or ListProducts. This feature is only available for
-        # users who have Retail Search enabled. Please submit a form [here](https://
-        # cloud.google.com/contact) to contact cloud sales if you are interested in
-        # using Retail Search.
+        # users who have Retail Search enabled. Please enable Retail Search on Cloud
+        # Console before using this feature.
         # @param [String] product
         #   Required. Full resource name of Product, such as `projects/*/locations/global/
         #   catalogs/default_catalog/branches/default_branch/products/some_product_id`. If
@@ -671,6 +715,50 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Remove local inventory information for a Product at a list of places at a
+        # removal timestamp. This process is asynchronous. If the request is valid, the
+        # removal will be enqueued and processed downstream. As a consequence, when a
+        # response is returned, removals are not immediately manifested in the Product
+        # queried by GetProduct or ListProducts. Local inventory information can only be
+        # removed using this method. CreateProduct and UpdateProduct has no effect on
+        # local inventories. This feature is only available for users who have Retail
+        # Search enabled. Please enable Retail Search on Cloud Console before using this
+        # feature.
+        # @param [String] product
+        #   Required. Full resource name of Product, such as `projects/*/locations/global/
+        #   catalogs/default_catalog/branches/default_branch/products/some_product_id`. If
+        #   the caller does not have permission to access the Product, regardless of
+        #   whether or not it exists, a PERMISSION_DENIED error is returned.
+        # @param [Google::Apis::RetailV2::GoogleCloudRetailV2RemoveLocalInventoriesRequest] google_cloud_retail_v2_remove_local_inventories_request_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::RetailV2::GoogleLongrunningOperation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::RetailV2::GoogleLongrunningOperation]
+        #
+        # @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 remove_project_location_catalog_branch_product_local_inventories(product, google_cloud_retail_v2_remove_local_inventories_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v2/{+product}:removeLocalInventories', options)
+          command.request_representation = Google::Apis::RetailV2::GoogleCloudRetailV2RemoveLocalInventoriesRequest::Representation
+          command.request_object = google_cloud_retail_v2_remove_local_inventories_request_object
+          command.response_representation = Google::Apis::RetailV2::GoogleLongrunningOperation::Representation
+          command.response_class = Google::Apis::RetailV2::GoogleLongrunningOperation
+          command.params['product'] = product unless product.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Updates inventory information for a Product while respecting the last update
         # timestamps of each inventory field. This process is asynchronous and does not
         # require the Product to exist before updating fulfillment information. If the
@@ -687,9 +775,8 @@ module Google
         # SetInventoryRequest.set_mask, then any existing inventory information will be
         # preserved. Pre-existing inventory information can only be updated with
         # SetInventory, AddFulfillmentPlaces, and RemoveFulfillmentPlaces. This feature
-        # is only available for users who have Retail Search enabled. Please submit a
-        # form [here](https://cloud.google.com/contact) to contact cloud sales if you
-        # are interested in using Retail Search.
+        # is only available for users who have Retail Search enabled. Please enable
+        # Retail Search on Cloud Console before using this feature.
         # @param [String] name
         #   Immutable. Full resource name of the product, such as `projects/*/locations/
         #   global/catalogs/default_catalog/branches/default_branch/products/product_id`.
@@ -727,9 +814,8 @@ module Google
         # asynchronous. Partial updating is not supported. The operation is successfully
         # finished only after the imported suggestions are indexed successfully and
         # ready for serving. The process takes hours. This feature is only available for
-        # users who have Retail Search enabled. Please submit a form [here](https://
-        # cloud.google.com/contact) to contact cloud sales if you are interested in
-        # using Retail Search.
+        # users who have Retail Search enabled. Please enable Retail Search on Cloud
+        # Console before using this feature.
         # @param [String] parent
         #   Required. The catalog which the suggestions dataset belongs to. Format: `
         #   projects/1234/locations/global/catalogs/default_catalog`.
@@ -843,13 +929,15 @@ module Google
         # Makes a recommendation prediction.
         # @param [String] placement
         #   Required. Full resource name of the format: `name=projects/*/locations/global/
-        #   catalogs/default_catalog/placements/*` or `name=projects/*/locations/global/
-        #   catalogs/default_catalog/servingConfigs/*` The ID of the Recommendations AI
-        #   placement. Before you can request predictions from your model, you must create
-        #   at least one placement for it. For more information, see [Managing placements](
-        #   https://cloud.google.com/retail/recommendations-ai/docs/manage-placements).
-        #   The full list of available placements can be seen at https://console.cloud.
-        #   google.com/recommendation/catalogs/default_catalog/placements
+        #   catalogs/default_catalog/servingConfigs/*` or `name=projects/*/locations/
+        #   global/catalogs/default_catalog/placements/*`. We recommend using the `
+        #   servingConfigs` resource. `placements` is a legacy resource. The ID of the
+        #   Recommendations AI serving config or placement. Before you can request
+        #   predictions from your model, you must create at least one serving config or
+        #   placement for it. For more information, see [Managing serving configurations] (
+        #   https://cloud.google.com/retail/docs/manage-configs). The full list of
+        #   available serving configs can be seen at https://console.cloud.google.com/ai/
+        #   retail/catalogs/default_catalog/configs
         # @param [Google::Apis::RetailV2::GoogleCloudRetailV2PredictRequest] google_cloud_retail_v2_predict_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -881,14 +969,15 @@ module Google
         end
         
         # Performs a search. This feature is only available for users who have Retail
-        # Search enabled. Please submit a form [here](https://cloud.google.com/contact)
-        # to contact cloud sales if you are interested in using Retail Search.
+        # Search enabled. Please enable Retail Search on Cloud Console before using this
+        # feature.
         # @param [String] placement
-        #   Required. The resource name of the search engine placement, such as `projects/*
-        #   /locations/global/catalogs/default_catalog/placements/default_search` or `
+        #   Required. The resource name of the Retail Search serving config, such as `
         #   projects/*/locations/global/catalogs/default_catalog/servingConfigs/
-        #   default_serving_config` This field is used to identify the serving
-        #   configuration name and the set of models that will be used to make the search.
+        #   default_serving_config` or the name of the legacy placement resource, such as `
+        #   projects/*/locations/global/catalogs/default_catalog/placements/default_search`
+        #   . This field is used to identify the serving configuration name and the set of
+        #   models that will be used to make the search.
         # @param [Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequest] google_cloud_retail_v2_search_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -922,13 +1011,15 @@ module Google
         # Makes a recommendation prediction.
         # @param [String] placement
         #   Required. Full resource name of the format: `name=projects/*/locations/global/
-        #   catalogs/default_catalog/placements/*` or `name=projects/*/locations/global/
-        #   catalogs/default_catalog/servingConfigs/*` The ID of the Recommendations AI
-        #   placement. Before you can request predictions from your model, you must create
-        #   at least one placement for it. For more information, see [Managing placements](
-        #   https://cloud.google.com/retail/recommendations-ai/docs/manage-placements).
-        #   The full list of available placements can be seen at https://console.cloud.
-        #   google.com/recommendation/catalogs/default_catalog/placements
+        #   catalogs/default_catalog/servingConfigs/*` or `name=projects/*/locations/
+        #   global/catalogs/default_catalog/placements/*`. We recommend using the `
+        #   servingConfigs` resource. `placements` is a legacy resource. The ID of the
+        #   Recommendations AI serving config or placement. Before you can request
+        #   predictions from your model, you must create at least one serving config or
+        #   placement for it. For more information, see [Managing serving configurations] (
+        #   https://cloud.google.com/retail/docs/manage-configs). The full list of
+        #   available serving configs can be seen at https://console.cloud.google.com/ai/
+        #   retail/catalogs/default_catalog/configs
         # @param [Google::Apis::RetailV2::GoogleCloudRetailV2PredictRequest] google_cloud_retail_v2_predict_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -960,14 +1051,15 @@ module Google
         end
         
         # Performs a search. This feature is only available for users who have Retail
-        # Search enabled. Please submit a form [here](https://cloud.google.com/contact)
-        # to contact cloud sales if you are interested in using Retail Search.
+        # Search enabled. Please enable Retail Search on Cloud Console before using this
+        # feature.
         # @param [String] placement
-        #   Required. The resource name of the search engine placement, such as `projects/*
-        #   /locations/global/catalogs/default_catalog/placements/default_search` or `
+        #   Required. The resource name of the Retail Search serving config, such as `
         #   projects/*/locations/global/catalogs/default_catalog/servingConfigs/
-        #   default_serving_config` This field is used to identify the serving
-        #   configuration name and the set of models that will be used to make the search.
+        #   default_serving_config` or the name of the legacy placement resource, such as `
+        #   projects/*/locations/global/catalogs/default_catalog/placements/default_search`
+        #   . This field is used to identify the serving configuration name and the set of
+        #   models that will be used to make the search.
         # @param [Google::Apis::RetailV2::GoogleCloudRetailV2SearchRequest] google_cloud_retail_v2_search_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-retail_v2
 version: !ruby/object:Gem::Version
-  version: 0.32.0
+  version: 0.35.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-03-28 00:00:00.000000000 Z
+date: 2022-04-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-retail_v2/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-retail_v2/v0.32.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-retail_v2/v0.35.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-retail_v2
 post_install_message: 
 rdoc_options: []