Retail V2 API - Class Google::Cloud::Retail::V2::Product (v0.9.0)

Reference documentation and code samples for the Retail V2 API class Google::Cloud::Retail::V2::Product.

Product captures all metadata information of items to be recommended or searched.

Inherits

  • Object

Extended By

  • Google::Protobuf::MessageExts::ClassMethods

Includes

  • Google::Protobuf::MessageExts

Methods

#attributes

def attributes() -> ::Google::Protobuf::Map{::String => ::Google::Cloud::Retail::V2::CustomAttribute}
Returns
  • (::Google::Protobuf::Map{::String => ::Google::Cloud::Retail::V2::CustomAttribute}) —

    Highly encouraged. Extra product attributes to be included. For example, for products, this could include the store name, vendor, style, color, etc. These are very strong signals for recommendation model, thus we highly recommend providing the attributes here.

    Features that can take on one of a limited number of possible values. Two types of features can be set are:

    Textual features. some examples would be the brand/maker of a product, or country of a customer. Numerical features. Some examples would be the height/weight of a product, or age of a customer.

    For example: { "vendor": {"text": ["vendor123", "vendor456"]}, "lengths_cm": \\{"numbers":[2.3, 15.4]}, "heights_cm": \\{"numbers":[8.1, 6.4]} }.

    This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned:

    • Max entries count: 200.
    • The key must be a UTF-8 encoded string with a length limit of 128 characters.
    • For indexable attribute, the key must match the pattern: [a-zA-Z0-9][a-zA-Z0-9_]*. For example, key0LikeThis or KEY_1_LIKE_THIS.
    • For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a non-empty UTF-8 encoded string with a length limit of 256 characters.
    • For number attributes, at most 400 values are allowed.

#attributes=

def attributes=(value) -> ::Google::Protobuf::Map{::String => ::Google::Cloud::Retail::V2::CustomAttribute}
Parameter
  • value (::Google::Protobuf::Map{::String => ::Google::Cloud::Retail::V2::CustomAttribute}) —

    Highly encouraged. Extra product attributes to be included. For example, for products, this could include the store name, vendor, style, color, etc. These are very strong signals for recommendation model, thus we highly recommend providing the attributes here.

    Features that can take on one of a limited number of possible values. Two types of features can be set are:

    Textual features. some examples would be the brand/maker of a product, or country of a customer. Numerical features. Some examples would be the height/weight of a product, or age of a customer.

    For example: { "vendor": {"text": ["vendor123", "vendor456"]}, "lengths_cm": \\{"numbers":[2.3, 15.4]}, "heights_cm": \\{"numbers":[8.1, 6.4]} }.

    This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned:

    • Max entries count: 200.
    • The key must be a UTF-8 encoded string with a length limit of 128 characters.
    • For indexable attribute, the key must match the pattern: [a-zA-Z0-9][a-zA-Z0-9_]*. For example, key0LikeThis or KEY_1_LIKE_THIS.
    • For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a non-empty UTF-8 encoded string with a length limit of 256 characters.
    • For number attributes, at most 400 values are allowed.
Returns
  • (::Google::Protobuf::Map{::String => ::Google::Cloud::Retail::V2::CustomAttribute}) —

    Highly encouraged. Extra product attributes to be included. For example, for products, this could include the store name, vendor, style, color, etc. These are very strong signals for recommendation model, thus we highly recommend providing the attributes here.

    Features that can take on one of a limited number of possible values. Two types of features can be set are:

    Textual features. some examples would be the brand/maker of a product, or country of a customer. Numerical features. Some examples would be the height/weight of a product, or age of a customer.

    For example: { "vendor": {"text": ["vendor123", "vendor456"]}, "lengths_cm": \\{"numbers":[2.3, 15.4]}, "heights_cm": \\{"numbers":[8.1, 6.4]} }.

    This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned:

    • Max entries count: 200.
    • The key must be a UTF-8 encoded string with a length limit of 128 characters.
    • For indexable attribute, the key must match the pattern: [a-zA-Z0-9][a-zA-Z0-9_]*. For example, key0LikeThis or KEY_1_LIKE_THIS.
    • For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a non-empty UTF-8 encoded string with a length limit of 256 characters.
    • For number attributes, at most 400 values are allowed.

#audience

def audience() -> ::Google::Cloud::Retail::V2::Audience
Returns

#audience=

def audience=(value) -> ::Google::Cloud::Retail::V2::Audience
Parameter
Returns

#availability

def availability() -> ::Google::Cloud::Retail::V2::Product::Availability
Returns

#availability=

def availability=(value) -> ::Google::Cloud::Retail::V2::Product::Availability
Parameter
Returns

#available_quantity

def available_quantity() -> ::Google::Protobuf::Int32Value
Returns

#available_quantity=

def available_quantity=(value) -> ::Google::Protobuf::Int32Value
Parameter
Returns

#available_time

def available_time() -> ::Google::Protobuf::Timestamp
Returns

#available_time=

def available_time=(value) -> ::Google::Protobuf::Timestamp
Parameter
Returns

#brands

def brands() -> ::Array<::String>
Returns
  • (::Array<::String>) — The brands of the product.

    A maximum of 30 brands are allowed. Each brand must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property brand. Schema.org property Product.brand.

#brands=

def brands=(value) -> ::Array<::String>
Parameter
  • value (::Array<::String>) — The brands of the product.

    A maximum of 30 brands are allowed. Each brand must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property brand. Schema.org property Product.brand.

Returns
  • (::Array<::String>) — The brands of the product.

    A maximum of 30 brands are allowed. Each brand must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property brand. Schema.org property Product.brand.

#categories

def categories() -> ::Array<::String>
Returns
  • (::Array<::String>) — Product categories. This field is repeated for supporting one product belonging to several parallel categories. Strongly recommended using the full path for better search / recommendation quality.

    To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, please replace it with other character(s).

    For example, if a shoes product belongs to both ["Shoes & Accessories" -> "Shoes"] and ["Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be represented as:

     "categories": [
   "Shoes & Accessories > Shoes",
   "Sports & Fitness > Athletic Clothing > Shoes"
 ]

    Must be set for Type.PRIMARY Product otherwise an INVALID_ARGUMENT error is returned.

    At most 250 values are allowed per Product. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property google_product_category. Schema.org property Product.category.

#categories=

def categories=(value) -> ::Array<::String>
Parameter
  • value (::Array<::String>) — Product categories. This field is repeated for supporting one product belonging to several parallel categories. Strongly recommended using the full path for better search / recommendation quality.

    To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, please replace it with other character(s).

    For example, if a shoes product belongs to both ["Shoes & Accessories" -> "Shoes"] and ["Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be represented as:

     "categories": [
   "Shoes & Accessories > Shoes",
   "Sports & Fitness > Athletic Clothing > Shoes"
 ]

    Must be set for Type.PRIMARY Product otherwise an INVALID_ARGUMENT error is returned.

    At most 250 values are allowed per Product. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property google_product_category. Schema.org property Product.category.

Returns
  • (::Array<::String>) — Product categories. This field is repeated for supporting one product belonging to several parallel categories. Strongly recommended using the full path for better search / recommendation quality.

    To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, please replace it with other character(s).

    For example, if a shoes product belongs to both ["Shoes & Accessories" -> "Shoes"] and ["Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be represented as:

     "categories": [
   "Shoes & Accessories > Shoes",
   "Sports & Fitness > Athletic Clothing > Shoes"
 ]

    Must be set for Type.PRIMARY Product otherwise an INVALID_ARGUMENT error is returned.

    At most 250 values are allowed per Product. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property google_product_category. Schema.org property Product.category.

#collection_member_ids

def collection_member_ids() -> ::Array<::String>
Returns
  • (::Array<::String>) — The id of the collection members when type is Type.COLLECTION.

    Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise and INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.

#collection_member_ids=

def collection_member_ids=(value) -> ::Array<::String>
Parameter
  • value (::Array<::String>) — The id of the collection members when type is Type.COLLECTION.

    Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise and INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.

Returns
  • (::Array<::String>) — The id of the collection members when type is Type.COLLECTION.

    Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise and INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.

#color_info

def color_info() -> ::Google::Cloud::Retail::V2::ColorInfo
Returns

#color_info=

def color_info=(value) -> ::Google::Cloud::Retail::V2::ColorInfo
Parameter
Returns

#conditions

def conditions() -> ::Array<::String>
Returns
  • (::Array<::String>) — The condition of the product. Strongly encouraged to use the standard values: "new", "refurbished", "used".

    A maximum of 1 value is allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property condition. Schema.org property Offer.itemCondition.

#conditions=

def conditions=(value) -> ::Array<::String>
Parameter
  • value (::Array<::String>) — The condition of the product. Strongly encouraged to use the standard values: "new", "refurbished", "used".

    A maximum of 1 value is allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property condition. Schema.org property Offer.itemCondition.

Returns
  • (::Array<::String>) — The condition of the product. Strongly encouraged to use the standard values: "new", "refurbished", "used".

    A maximum of 1 value is allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property condition. Schema.org property Offer.itemCondition.

#description

def description() -> ::String
Returns
  • (::String) — Product description.

    This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property description. Schema.org property Product.description.

#description=

def description=(value) -> ::String
Parameter
  • value (::String) — Product description.

    This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property description. Schema.org property Product.description.

Returns
  • (::String) — Product description.

    This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property description. Schema.org property Product.description.

#expire_time

def expire_time() -> ::Google::Protobuf::Timestamp
Returns

#expire_time=

def expire_time=(value) -> ::Google::Protobuf::Timestamp
Parameter
Returns

#fulfillment_info

def fulfillment_info() -> ::Array<::Google::Cloud::Retail::V2::FulfillmentInfo>
Returns

#fulfillment_info=

def fulfillment_info=(value) -> ::Array<::Google::Cloud::Retail::V2::FulfillmentInfo>
Parameter
Returns

#gtin

def gtin() -> ::String
Returns
  • (::String) — The Global Trade Item Number (GTIN) of the product.

    This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    This field must be a Unigram. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property gtin. Schema.org property Product.isbn, Product.gtin8, Product.gtin12, Product.gtin13, or Product.gtin14.

    If the value is not a valid GTIN, an INVALID_ARGUMENT error is returned.

#gtin=

def gtin=(value) -> ::String
Parameter
  • value (::String) — The Global Trade Item Number (GTIN) of the product.

    This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    This field must be a Unigram. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property gtin. Schema.org property Product.isbn, Product.gtin8, Product.gtin12, Product.gtin13, or Product.gtin14.

    If the value is not a valid GTIN, an INVALID_ARGUMENT error is returned.

Returns
  • (::String) — The Global Trade Item Number (GTIN) of the product.

    This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    This field must be a Unigram. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property gtin. Schema.org property Product.isbn, Product.gtin8, Product.gtin12, Product.gtin13, or Product.gtin14.

    If the value is not a valid GTIN, an INVALID_ARGUMENT error is returned.

#id

def id() -> ::String
Returns
  • (::String) — Immutable. Product identifier, which is the final component of name. For example, this field is "id_1", if name is projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/id_1.

    This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property id. Schema.org property Product.sku.

#id=

def id=(value) -> ::String
Parameter
  • value (::String) — Immutable. Product identifier, which is the final component of name. For example, this field is "id_1", if name is projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/id_1.

    This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property id. Schema.org property Product.sku.

Returns
  • (::String) — Immutable. Product identifier, which is the final component of name. For example, this field is "id_1", if name is projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/id_1.

    This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property id. Schema.org property Product.sku.

#images

def images() -> ::Array<::Google::Cloud::Retail::V2::Image>
Returns

#images=

def images=(value) -> ::Array<::Google::Cloud::Retail::V2::Image>
Parameter
Returns

#language_code

def language_code() -> ::String
Returns
  • (::String) — Language of the title/description and other string attributes. Use language tags defined by BCP 47.

    For product prediction, this field is ignored and the model automatically detects the text language. The Product can include text in different languages, but duplicating Products to provide text in multiple languages can result in degraded model performance.

    For product search this field is in use. It defaults to "en-US" if unset.

#language_code=

def language_code=(value) -> ::String
Parameter
  • value (::String) — Language of the title/description and other string attributes. Use language tags defined by BCP 47.

    For product prediction, this field is ignored and the model automatically detects the text language. The Product can include text in different languages, but duplicating Products to provide text in multiple languages can result in degraded model performance.

    For product search this field is in use. It defaults to "en-US" if unset.

Returns
  • (::String) — Language of the title/description and other string attributes. Use language tags defined by BCP 47.

    For product prediction, this field is ignored and the model automatically detects the text language. The Product can include text in different languages, but duplicating Products to provide text in multiple languages can result in degraded model performance.

    For product search this field is in use. It defaults to "en-US" if unset.

#materials

def materials() -> ::Array<::String>
Returns
  • (::Array<::String>) — The material of the product. For example, "leather", "wooden".

    A maximum of 20 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 200 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property material. Schema.org property Product.material.

#materials=

def materials=(value) -> ::Array<::String>
Parameter
  • value (::Array<::String>) — The material of the product. For example, "leather", "wooden".

    A maximum of 20 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 200 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property material. Schema.org property Product.material.

Returns
  • (::Array<::String>) — The material of the product. For example, "leather", "wooden".

    A maximum of 20 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 200 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property material. Schema.org property Product.material.

#name

def name() -> ::String
Returns
  • (::String) — Immutable. Full resource name of the product, such as projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/product_id.

#name=

def name=(value) -> ::String
Parameter
  • value (::String) — Immutable. Full resource name of the product, such as projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/product_id.
Returns
  • (::String) — Immutable. Full resource name of the product, such as projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/product_id.

#patterns

def patterns() -> ::Array<::String>
Returns
  • (::Array<::String>) — The pattern or graphic print of the product. For example, "striped", "polka dot", "paisley".

    A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property pattern. Schema.org property Product.pattern.

#patterns=

def patterns=(value) -> ::Array<::String>
Parameter
  • value (::Array<::String>) — The pattern or graphic print of the product. For example, "striped", "polka dot", "paisley".

    A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property pattern. Schema.org property Product.pattern.

Returns
  • (::Array<::String>) — The pattern or graphic print of the product. For example, "striped", "polka dot", "paisley".

    A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property pattern. Schema.org property Product.pattern.

#price_info

def price_info() -> ::Google::Cloud::Retail::V2::PriceInfo
Returns

#price_info=

def price_info=(value) -> ::Google::Cloud::Retail::V2::PriceInfo
Parameter
Returns

#primary_product_id

def primary_product_id() -> ::String
Returns
  • (::String) — Variant group identifier. Must be an id, with the same parent branch with this product. Otherwise, an error is thrown.

    For Type.PRIMARY Products, this field can only be empty or set to the same value as id.

    For VARIANT Products, this field cannot be empty. A maximum of 2,000 products are allowed to share the same Type.PRIMARY Product. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property item_group_id. Schema.org property Product.inProductGroupWithID.

#primary_product_id=

def primary_product_id=(value) -> ::String
Parameter
  • value (::String) — Variant group identifier. Must be an id, with the same parent branch with this product. Otherwise, an error is thrown.

    For Type.PRIMARY Products, this field can only be empty or set to the same value as id.

    For VARIANT Products, this field cannot be empty. A maximum of 2,000 products are allowed to share the same Type.PRIMARY Product. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property item_group_id. Schema.org property Product.inProductGroupWithID.

Returns
  • (::String) — Variant group identifier. Must be an id, with the same parent branch with this product. Otherwise, an error is thrown.

    For Type.PRIMARY Products, this field can only be empty or set to the same value as id.

    For VARIANT Products, this field cannot be empty. A maximum of 2,000 products are allowed to share the same Type.PRIMARY Product. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property item_group_id. Schema.org property Product.inProductGroupWithID.

#promotions

def promotions() -> ::Array<::Google::Cloud::Retail::V2::Promotion>
Returns

#promotions=

def promotions=(value) -> ::Array<::Google::Cloud::Retail::V2::Promotion>
Parameter
Returns

#publish_time

def publish_time() -> ::Google::Protobuf::Timestamp
Returns
  • (::Google::Protobuf::Timestamp) — The timestamp when the product is published by the retailer for the first time, which indicates the freshness of the products. Note that this field is different from available_time, given it purely describes product freshness regardless of when it is available on search and recommendation.

#publish_time=

def publish_time=(value) -> ::Google::Protobuf::Timestamp
Parameter
  • value (::Google::Protobuf::Timestamp) — The timestamp when the product is published by the retailer for the first time, which indicates the freshness of the products. Note that this field is different from available_time, given it purely describes product freshness regardless of when it is available on search and recommendation.
Returns
  • (::Google::Protobuf::Timestamp) — The timestamp when the product is published by the retailer for the first time, which indicates the freshness of the products. Note that this field is different from available_time, given it purely describes product freshness regardless of when it is available on search and recommendation.

#rating

def rating() -> ::Google::Cloud::Retail::V2::Rating
Returns

#rating=

def rating=(value) -> ::Google::Cloud::Retail::V2::Rating
Parameter
Returns

#retrievable_fields

def retrievable_fields() -> ::Google::Protobuf::FieldMask
Returns

#retrievable_fields=

def retrievable_fields=(value) -> ::Google::Protobuf::FieldMask
Parameter
Returns

#sizes

def sizes() -> ::Array<::String>
Returns
  • (::Array<::String>) — The size of the product. To represent different size systems or size types, consider using this format: [[[size_system:]size_type:]size_value].

    For example, in "US:MENS:M", "US" represents size system; "MENS" represents size type; "M" represents size value. In "GIRLS:27", size system is empty; "GIRLS" represents size type; "27" represents size value. In "32 inches", both size system and size type are empty, while size value is "32 inches".

    A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property size, size_type, and size_system. Schema.org property Product.size.

#sizes=

def sizes=(value) -> ::Array<::String>
Parameter
  • value (::Array<::String>) — The size of the product. To represent different size systems or size types, consider using this format: [[[size_system:]size_type:]size_value].

    For example, in "US:MENS:M", "US" represents size system; "MENS" represents size type; "M" represents size value. In "GIRLS:27", size system is empty; "GIRLS" represents size type; "27" represents size value. In "32 inches", both size system and size type are empty, while size value is "32 inches".

    A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property size, size_type, and size_system. Schema.org property Product.size.

Returns
  • (::Array<::String>) — The size of the product. To represent different size systems or size types, consider using this format: [[[size_system:]size_type:]size_value].

    For example, in "US:MENS:M", "US" represents size system; "MENS" represents size type; "M" represents size value. In "GIRLS:27", size system is empty; "GIRLS" represents size type; "27" represents size value. In "32 inches", both size system and size type are empty, while size value is "32 inches".

    A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property size, size_type, and size_system. Schema.org property Product.size.

#tags

def tags() -> ::Array<::String>
Returns
  • (::Array<::String>) — Custom tags associated with the product.

    At most 250 values are allowed per Product. This value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    This tag can be used for filtering recommendation results by passing the tag as part of the PredictRequest.filter.

    Corresponding properties: Google Merchant Center property custom_label_0–4.

#tags=

def tags=(value) -> ::Array<::String>
Parameter
  • value (::Array<::String>) — Custom tags associated with the product.

    At most 250 values are allowed per Product. This value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    This tag can be used for filtering recommendation results by passing the tag as part of the PredictRequest.filter.

    Corresponding properties: Google Merchant Center property custom_label_0–4.

Returns
  • (::Array<::String>) — Custom tags associated with the product.

    At most 250 values are allowed per Product. This value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    This tag can be used for filtering recommendation results by passing the tag as part of the PredictRequest.filter.

    Corresponding properties: Google Merchant Center property custom_label_0–4.

#title

def title() -> ::String
Returns
  • (::String) — Required. Product title.

    This field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property title. Schema.org property Product.name.

#title=

def title=(value) -> ::String
Parameter
  • value (::String) — Required. Product title.

    This field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property title. Schema.org property Product.name.

Returns
  • (::String) — Required. Product title.

    This field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property title. Schema.org property Product.name.

#ttl

def ttl() -> ::Google::Protobuf::Duration
Returns

#ttl=

def ttl=(value) -> ::Google::Protobuf::Duration
Parameter
Returns

#type

def type() -> ::Google::Cloud::Retail::V2::Product::Type
Returns

#type=

def type=(value) -> ::Google::Cloud::Retail::V2::Product::Type
Parameter
Returns

#uri

def uri() -> ::String
Returns
  • (::String) — Canonical URL directly linking to the product detail page.

    It is strongly recommended to provide a valid uri for the product, otherwise the service performance could be significantly degraded.

    This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property link. Schema.org property Offer.url.

#uri=

def uri=(value) -> ::String
Parameter
  • value (::String) — Canonical URL directly linking to the product detail page.

    It is strongly recommended to provide a valid uri for the product, otherwise the service performance could be significantly degraded.

    This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property link. Schema.org property Offer.url.

Returns
  • (::String) — Canonical URL directly linking to the product detail page.

    It is strongly recommended to provide a valid uri for the product, otherwise the service performance could be significantly degraded.

    This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.

    Corresponding properties: Google Merchant Center property link. Schema.org property Offer.url.

#variants

def variants() -> ::Array<::Google::Cloud::Retail::V2::Product>
Returns