google-cloud-retail-v2 0.2.0 → 0.4.0

data/lib/google/cloud/retail/v2/user_event_service/paths.rb

@@ -24,6 +24,25 @@ module Google
         module UserEventService
           # Path helper methods for the UserEventService API.
           module Paths
+            ##
+            # Create a fully-qualified Catalog resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/catalogs/{catalog}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param catalog [String]
+            #
+            # @return [::String]
+            def catalog_path project:, location:, catalog:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/catalogs/#{catalog}"
+            end
+
             ##
             # Create a fully-qualified Product resource string.
             #

data/lib/google/cloud/retail/v2/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Retail
       module V2
-        VERSION = "0.2.0"
+        VERSION = "0.4.0"
       end
     end
   end

data/proto_docs/google/api/field_behavior.rb

@@ -57,9 +57,15 @@ module Google
 
       # Denotes that a (repeated) field is an unordered list.
       # This indicates that the service may provide the elements of the list
-      # in any arbitrary order, rather than the order the user originally
+      # in any arbitrary  order, rather than the order the user originally
       # provided. Additionally, the list's order may or may not be stable.
       UNORDERED_LIST = 6
+
+      # Denotes that this field returns a non-empty default value if not set.
+      # This indicates that if the user provides the empty value in a request,
+      # a non-empty value will be returned. The user will not be aware of what
+      # non-empty value to expect.
+      NON_EMPTY_DEFAULT = 7
     end
   end
 end

data/proto_docs/google/api/httpbody.rb

@@ -43,7 +43,8 @@ module Google
     #
     #     service ResourceService {
     #       rpc GetResource(GetResourceRequest) returns (google.api.HttpBody);
-    #       rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty);
+    #       rpc UpdateResource(google.api.HttpBody) returns
+    #       (google.protobuf.Empty);
     #     }
     #
     # Example with streaming methods:
@@ -59,10 +60,10 @@ module Google
     # handled, all other features will continue to work unchanged.
     # @!attribute [rw] content_type
     #   @return [::String]
-    #     The HTTP Content-Type string representing the content type of the body.
+    #     The HTTP Content-Type header value specifying the content type of the body.
     # @!attribute [rw] data
     #   @return [::String]
-    #     HTTP body binary data.
+    #     The HTTP request/response body as raw binary.
     # @!attribute [rw] extensions
     #   @return [::Array<::Google::Protobuf::Any>]
     #     Application specific response metadata. Must be set in the first response

data/proto_docs/google/cloud/retail/v2/catalog.rb

@@ -48,9 +48,9 @@ module Google
         #     {::Google::Cloud::Retail::V2::ProductLevelConfig#merchant_center_product_id_field merchant_center_product_id_field}
         #     is `itemGroupId`, an INVALID_ARGUMENT error is returned.
         #
-        #     See [Using catalog
-        #     levels](/retail/recommendations-ai/docs/catalog#catalog-levels) for more
-        #     details.
+        #     See [Using product
+        #     levels](https://cloud.google.com/retail/recommendations-ai/docs/catalog#product-levels)
+        #     for more details.
         # @!attribute [rw] merchant_center_product_id_field
         #   @return [::String]
         #     Which field of [Merchant Center
@@ -70,9 +70,9 @@ module Google
         #     {::Google::Cloud::Retail::V2::ProductLevelConfig#ingestion_product_type ingestion_product_type}
         #     is `variant`, an INVALID_ARGUMENT error is returned.
         #
-        #     See [Using catalog
-        #     levels](/retail/recommendations-ai/docs/catalog#catalog-levels) for more
-        #     details.
+        #     See [Using product
+        #     levels](https://cloud.google.com/retail/recommendations-ai/docs/catalog#product-levels)
+        #     for more details.
         class ProductLevelConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/retail/v2/catalog_service.rb

@@ -89,10 +89,7 @@ module Google
         # @!attribute [rw] update_mask
         #   @return [::Google::Protobuf::FieldMask]
         #     Indicates which fields in the provided
-        #     {::Google::Cloud::Retail::V2::Catalog Catalog} to update. If not set, will only
-        #     update the
-        #     {::Google::Cloud::Retail::V2::Catalog#product_level_config Catalog.product_level_config}
-        #     field, which is also the only currently supported field to update.
+        #     {::Google::Cloud::Retail::V2::Catalog Catalog} to update.
         #
         #     If an unsupported or unknown field is provided, an INVALID_ARGUMENT error
         #     is returned.
@@ -100,6 +97,58 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # Request message to set a specified branch as new default_branch.
+        # @!attribute [rw] catalog
+        #   @return [::String]
+        #     Full resource name of the catalog, such as
+        #     `projects/*/locations/global/catalogs/default_catalog`.
+        # @!attribute [rw] branch_id
+        #   @return [::String]
+        #     The final component of the resource name of a branch.
+        #
+        #     This field must be one of "0", "1" or "2". Otherwise, an INVALID_ARGUMENT
+        #     error is returned.
+        # @!attribute [rw] note
+        #   @return [::String]
+        #     Some note on this request, this can be retrieved by
+        #     {::Google::Cloud::Retail::V2::CatalogService::Client#get_default_branch CatalogService.GetDefaultBranch}
+        #     before next valid default branch set occurs.
+        #
+        #     This field must be a UTF-8 encoded string with a length limit of 1,000
+        #     characters. Otherwise, an INVALID_ARGUMENT error is returned.
+        class SetDefaultBranchRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message to show which branch is currently the default branch.
+        # @!attribute [rw] catalog
+        #   @return [::String]
+        #     The parent catalog resource name, such as
+        #     `projects/*/locations/global/catalogs/default_catalog`.
+        class GetDefaultBranchRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message of
+        # {::Google::Cloud::Retail::V2::CatalogService::Client#get_default_branch CatalogService.GetDefaultBranch}.
+        # @!attribute [rw] branch
+        #   @return [::String]
+        #     Full resource name of the branch id currently set as default branch.
+        # @!attribute [rw] set_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The time when this branch is set to default.
+        # @!attribute [rw] note
+        #   @return [::String]
+        #     This corresponds to
+        #     {::Google::Cloud::Retail::V2::SetDefaultBranchRequest#note SetDefaultBranchRequest.note}
+        #     field, when this branch was set as default.
+        class GetDefaultBranchResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

data/proto_docs/google/cloud/retail/v2/common.rb

@@ -21,8 +21,79 @@ module Google
   module Cloud
     module Retail
       module V2
+        # An intended audience of the {::Google::Cloud::Retail::V2::Product Product} for
+        # whom it's sold.
+        # @!attribute [rw] genders
+        #   @return [::Array<::String>]
+        #     The genders of the audience. Strongly encouraged to use the standard
+        #     values: "male", "female", "unisex".
+        #
+        #     At most 5 values are allowed. Each value must be a UTF-8 encoded string
+        #     with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error
+        #     is returned.
+        #
+        #     Google Merchant Center property
+        #     [gender](https://support.google.com/merchants/answer/6324479). Schema.org
+        #     property
+        #     [Product.audience.suggestedGender](https://schema.org/suggestedGender).
+        # @!attribute [rw] age_groups
+        #   @return [::Array<::String>]
+        #     The age groups of the audience. Strongly encouraged to use the standard
+        #     values: "newborn" (up to 3 months old), "infant" (3–12 months old),
+        #     "toddler" (1–5 years old), "kids" (5–13 years old), "adult" (typically
+        #     teens or older).
+        #
+        #     At most 5 values are allowed. Each value must be a UTF-8 encoded string
+        #     with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error
+        #     is returned.
+        #
+        #     Google Merchant Center property
+        #     [age_group](https://support.google.com/merchants/answer/6324463).
+        #     Schema.org property
+        #     [Product.audience.suggestedMinAge](https://schema.org/suggestedMinAge) and
+        #     [Product.audience.suggestedMaxAge](https://schema.org/suggestedMaxAge).
+        class Audience
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The color information of a {::Google::Cloud::Retail::V2::Product Product}.
+        # @!attribute [rw] color_families
+        #   @return [::Array<::String>]
+        #     The standard color families. Strongly recommended to use the following
+        #     standard color groups: "Red", "Pink", "Orange", "Yellow", "Purple",
+        #     "Green", "Cyan", "Blue", "Brown", "White", "Gray", "Black" and
+        #     "Mixed". Normally it is expected to have only 1 color family. May consider
+        #     using single "Mixed" instead of multiple values.
+        #
+        #     A maximum of 5 values are allowed. Each value must be a UTF-8 encoded
+        #     string with a length limit of 128 characters. Otherwise, an
+        #     INVALID_ARGUMENT error is returned.
+        #
+        #     Google Merchant Center property
+        #     [color](https://support.google.com/merchants/answer/6324487). Schema.org
+        #     property [Product.color](https://schema.org/color).
+        # @!attribute [rw] colors
+        #   @return [::Array<::String>]
+        #     The color display names, which may be different from standard color family
+        #     names, such as the color aliases used in the website frontend. Normally
+        #     it is expected to have only 1 color. May consider using single "Mixed"
+        #     instead of multiple values.
+        #
+        #     A maximum of 5 colors are allowed. Each value must be a UTF-8 encoded
+        #     string with a length limit of 128 characters. Otherwise, an
+        #     INVALID_ARGUMENT error is returned.
+        #
+        #     Google Merchant Center property
+        #     [color](https://support.google.com/merchants/answer/6324487). Schema.org
+        #     property [Product.color](https://schema.org/color).
+        class ColorInfo
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # A custom attribute that is not explicitly modeled in
-        # {::Google::Cloud::Retail::V2::Product Product}].
+        # {::Google::Cloud::Retail::V2::Product Product}.
         # @!attribute [rw] text
         #   @return [::Array<::String>]
         #     The textual values of this custom attribute. For example, `["yellow",
@@ -46,11 +117,71 @@ module Google
         #     Exactly one of {::Google::Cloud::Retail::V2::CustomAttribute#text text} or
         #     {::Google::Cloud::Retail::V2::CustomAttribute#numbers numbers} should be set.
         #     Otherwise, an INVALID_ARGUMENT error is returned.
+        # @!attribute [rw] searchable
+        #   @return [::Boolean]
+        #     If true, custom attribute values are searchable by text queries in
+        #     {::Google::Cloud::Retail::V2::SearchService::Client#search SearchService.Search}.
+        #
+        #     This field is ignored in a {::Google::Cloud::Retail::V2::UserEvent UserEvent}.
+        #
+        #     Only set if type {::Google::Cloud::Retail::V2::CustomAttribute#text text} is
+        #     set. Otherwise, a INVALID_ARGUMENT error is returned.
+        # @!attribute [rw] indexable
+        #   @return [::Boolean]
+        #     If true, custom attribute values are indexed, so that it can be filtered,
+        #     faceted or boosted in
+        #     {::Google::Cloud::Retail::V2::SearchService::Client#search SearchService.Search}.
+        #
+        #     This field is ignored in a {::Google::Cloud::Retail::V2::UserEvent UserEvent}.
+        #
+        #     See {::Google::Cloud::Retail::V2::SearchRequest#filter SearchRequest.filter},
+        #     {::Google::Cloud::Retail::V2::SearchRequest#facet_specs SearchRequest.facet_specs}
+        #     and
+        #     {::Google::Cloud::Retail::V2::SearchRequest#boost_spec SearchRequest.boost_spec}
+        #     for more details.
         class CustomAttribute
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Fulfillment information, such as the store IDs for in-store pickup or region
+        # IDs for different shipping methods.
+        # @!attribute [rw] type
+        #   @return [::String]
+        #     The fulfillment type, including 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.
+        # @!attribute [rw] place_ids
+        #   @return [::Array<::String>]
+        #     The IDs for this {::Google::Cloud::Retail::V2::FulfillmentInfo#type type}, such
+        #     as the store IDs for
+        #     {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type.pickup-in-store}
+        #     or the region IDs for
+        #     {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type.same-day-delivery}.
+        #
+        #     A maximum of 2000 values are allowed. Each value must be a string with a
+        #     length limit of 10 characters, matching the pattern [a-zA-Z0-9_-]+, such as
+        #     "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
+        class FulfillmentInfo
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # {::Google::Cloud::Retail::V2::Product Product} thumbnail/detail image.
         # @!attribute [rw] uri
         #   @return [::String]
@@ -79,6 +210,24 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # A floating point interval.
+        # @!attribute [rw] minimum
+        #   @return [::Float]
+        #     Inclusive lower bound.
+        # @!attribute [rw] exclusive_minimum
+        #   @return [::Float]
+        #     Exclusive lower bound.
+        # @!attribute [rw] maximum
+        #   @return [::Float]
+        #     Inclusive upper bound.
+        # @!attribute [rw] exclusive_maximum
+        #   @return [::Float]
+        #     Exclusive upper bound.
+        class Interval
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # The price information of a {::Google::Cloud::Retail::V2::Product Product}.
         # @!attribute [rw] currency_code
         #   @return [::String]
@@ -87,6 +236,13 @@ module Google
         #
         #     If this field is an unrecognizable currency code, an INVALID_ARGUMENT
         #     error is returned.
+        #
+        #     The {::Google::Cloud::Retail::V2::Product::Type::VARIANT Product.Type.VARIANT}
+        #     {::Google::Cloud::Retail::V2::Product Product}s with the same
+        #     {::Google::Cloud::Retail::V2::Product#primary_product_id Product.primary_product_id}
+        #     must share the same
+        #     {::Google::Cloud::Retail::V2::PriceInfo#currency_code currency_code}. Otherwise,
+        #     a FAILED_PRECONDITION error is returned.
         # @!attribute [rw] price
         #   @return [::Float]
         #     Price of the product.
@@ -108,9 +264,102 @@ module Google
         #
         #     Google Merchant Center property
         #     [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+        # @!attribute [rw] price_effective_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The timestamp when the {::Google::Cloud::Retail::V2::PriceInfo#price price}
+        #     starts to be effective. This can be set as a future timestamp, and the
+        #     {::Google::Cloud::Retail::V2::PriceInfo#price price} is only used for search
+        #     after
+        #     {::Google::Cloud::Retail::V2::PriceInfo#price_effective_time price_effective_time}.
+        #     If so, the
+        #     {::Google::Cloud::Retail::V2::PriceInfo#original_price original_price} must be
+        #     set and {::Google::Cloud::Retail::V2::PriceInfo#original_price original_price}
+        #     is used before
+        #     {::Google::Cloud::Retail::V2::PriceInfo#price_effective_time price_effective_time}.
+        #
+        #     Do not set if {::Google::Cloud::Retail::V2::PriceInfo#price price} is always
+        #     effective because it will cause additional latency during search.
+        # @!attribute [rw] price_expire_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The timestamp when the {::Google::Cloud::Retail::V2::PriceInfo#price price}
+        #     stops to be effective. The {::Google::Cloud::Retail::V2::PriceInfo#price price}
+        #     is used for search before
+        #     {::Google::Cloud::Retail::V2::PriceInfo#price_expire_time price_expire_time}. If
+        #     this field is set, the
+        #     {::Google::Cloud::Retail::V2::PriceInfo#original_price original_price} must be
+        #     set and {::Google::Cloud::Retail::V2::PriceInfo#original_price original_price}
+        #     is used after
+        #     {::Google::Cloud::Retail::V2::PriceInfo#price_expire_time price_expire_time}.
+        #
+        #     Do not set if {::Google::Cloud::Retail::V2::PriceInfo#price price} is always
+        #     effective because it will cause additional latency during search.
+        # @!attribute [r] price_range
+        #   @return [::Google::Cloud::Retail::V2::PriceInfo::PriceRange]
+        #     Output only. The price range of all the child
+        #     {::Google::Cloud::Retail::V2::Product::Type::VARIANT Product.Type.VARIANT}
+        #     {::Google::Cloud::Retail::V2::Product Product}s grouped together on the
+        #     {::Google::Cloud::Retail::V2::Product::Type::PRIMARY Product.Type.PRIMARY}
+        #     {::Google::Cloud::Retail::V2::Product Product}. Only populated for
+        #     {::Google::Cloud::Retail::V2::Product::Type::PRIMARY Product.Type.PRIMARY}
+        #     {::Google::Cloud::Retail::V2::Product Product}s.
+        #
+        #     Note: This field is OUTPUT_ONLY for
+        #     {::Google::Cloud::Retail::V2::ProductService::Client#get_product ProductService.GetProduct}.
+        #     Do not set this field in API requests.
         class PriceInfo
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The price range of all
+          # {::Google::Cloud::Retail::V2::Product::Type::VARIANT variant}
+          # {::Google::Cloud::Retail::V2::Product Product} having the same
+          # {::Google::Cloud::Retail::V2::Product#primary_product_id Product.primary_product_id}.
+          # @!attribute [rw] price
+          #   @return [::Google::Cloud::Retail::V2::Interval]
+          #     The inclusive
+          #     {::Google::Cloud::Retail::V2::PriceInfo#price Product.pricing_info.price}
+          #     interval of all {::Google::Cloud::Retail::V2::Product::Type::VARIANT variant}
+          #     {::Google::Cloud::Retail::V2::Product Product} having the same
+          #     {::Google::Cloud::Retail::V2::Product#primary_product_id Product.primary_product_id}.
+          # @!attribute [rw] original_price
+          #   @return [::Google::Cloud::Retail::V2::Interval]
+          #     The inclusive
+          #     {::Google::Cloud::Retail::V2::PriceInfo#original_price Product.pricing_info.original_price}
+          #     internal of all {::Google::Cloud::Retail::V2::Product::Type::VARIANT variant}
+          #     {::Google::Cloud::Retail::V2::Product Product} having the same
+          #     {::Google::Cloud::Retail::V2::Product#primary_product_id Product.primary_product_id}.
+          class PriceRange
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # The rating of a {::Google::Cloud::Retail::V2::Product Product}.
+        # @!attribute [rw] rating_count
+        #   @return [::Integer]
+        #     The total number of ratings. This value is independent of the value of
+        #     {::Google::Cloud::Retail::V2::Rating#rating_histogram rating_histogram}.
+        #
+        #     This value must be nonnegative. Otherwise, an INVALID_ARGUMENT error is
+        #     returned.
+        # @!attribute [rw] average_rating
+        #   @return [::Float]
+        #     The average rating of the {::Google::Cloud::Retail::V2::Product Product}.
+        #
+        #     The rating is scaled at 1-5. Otherwise, an INVALID_ARGUMENT error is
+        #     returned.
+        # @!attribute [rw] rating_histogram
+        #   @return [::Array<::Integer>]
+        #     List of rating counts per rating value (index = rating - 1). The list is
+        #     empty if there is no rating. If the list is non-empty, its size is
+        #     always 5. Otherwise, an INVALID_ARGUMENT error is returned.
+        #
+        #     For example, [41, 14, 13, 47, 303]. It means that the
+        #     {::Google::Cloud::Retail::V2::Product Product} got 41 ratings with 1 star, 14
+        #     ratings with 2 star, and so on.
+        class Rating
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
         # Information of an end user.
@@ -123,8 +372,9 @@ module Google
         #     characters. Otherwise, an INVALID_ARGUMENT error is returned.
         # @!attribute [rw] ip_address
         #   @return [::String]
-        #     The end user's IP address. This field is used to extract location
-        #     information for personalization.
+        #     The end user's IP address. Required for getting
+        #     [SearchResponse.sponsored_results][google.cloud.retail.v2.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
@@ -137,7 +387,8 @@ module Google
         #     is set.
         # @!attribute [rw] user_agent
         #   @return [::String]
-        #     User agent as included in the HTTP header.
+        #     User agent as included in the HTTP header. Required for getting
+        #     [SearchResponse.sponsored_results][google.cloud.retail.v2.SearchResponse.sponsored_results].
         #
         #     The field must be a UTF-8 encoded string with a length limit of 1,000
         #     characters. Otherwise, an INVALID_ARGUMENT error is returned.
@@ -163,6 +414,23 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # Promotion information.
+        # @!attribute [rw] promotion_id
+        #   @return [::String]
+        #     ID of the promotion. For example, "free gift".
+        #
+        #     The value value must be a UTF-8 encoded string with a length limit of 128
+        #     characters, and match the pattern: [a-zA-Z][a-zA-Z0-9_]*. For example,
+        #     id0LikeThis or ID_1_LIKE_THIS. Otherwise, an INVALID_ARGUMENT error is
+        #     returned.
+        #
+        #     Google Merchant Center property
+        #     [promotion](https://support.google.com/merchants/answer/7050148).
+        class Promotion
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end