# REST Resource: projects.locations.products

- [Resource: Product](https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1p4beta1/projects.locations.products#Product)
  - [JSON representation](https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1p4beta1/projects.locations.products#Product.SCHEMA_REPRESENTATION)
- [KeyValue](https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1p4beta1/projects.locations.products#KeyValue)
  - [JSON representation](https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1p4beta1/projects.locations.products#KeyValue.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1p4beta1/projects.locations.products#METHODS_SUMMARY)

## Resource: Product

A Product contains ReferenceImages.

| JSON representation ||
|---|---|
| ``` { "name": string, "displayName": string, "description": string, "productCategory": string, "productLabels": [ { object (`https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1p4beta1/projects.locations.products#KeyValue`) } ] } ``` |

| Fields ||
|---|---|
| `name` | `string` The resource name of the product. Format is: `projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID`. This field is ignored when creating a product. <br /> |
| `displayName` | `string` The user-provided name for this Product. Must not be empty. Must be at most 4096 characters long. |
| `description` | `string` User-provided metadata to be stored with this product. Must be at most 4096 characters long. |
| `productCategory` | `string` The category for the product identified by the reference image. This should be either "homegoods-v2", "apparel-v2", "toys-v2", or "packagedgoods-v1". The legacy categories "homegoods", "apparel", and "toys" are still supported but will be deprecated. For new products, please use "homegoods-v2", "apparel-v2", or "toys-v2" for better product search accuracy. It is recommended to migrate existing products to these categories as well. This field is immutable. <br /> |
| `productLabels[]` | ``object (`https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1p4beta1/projects.locations.products#KeyValue`)`` Key-value pairs that can be attached to a product. At query time, constraints can be specified based on the productLabels. Note that integer values can be provided as strings, e.g. "1199". Only strings with integer values can match a range-based restriction which is to be supported soon. Multiple values can be assigned to the same key. One product may have up to 100 productLabels. <br /> |

## KeyValue

A product label represented as a key-value pair.

| JSON representation ||
|---|---|
| ``` { "key": string, "value": string } ``` |

| Fields ||
|---|---|
| `key` | `string` The key of the label attached to the product. Cannot be empty and cannot exceed 128 bytes. |
| `value` | `string` The value of the label attached to the product. Cannot be empty and cannot exceed 128 bytes. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1p4beta1/projects.locations.products/create` | Creates and returns a new product resource. |
| ### `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1p4beta1/projects.locations.products/delete` | Permanently deletes a product and its reference images. |
| ### `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1p4beta1/projects.locations.products/get` | Gets information associated with a Product. |
| ### `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1p4beta1/projects.locations.products/list` | Lists products in an unspecified order. |
| ### `https://docs.cloud.google.com/vision/product-search/docs/reference/rest/v1p4beta1/projects.locations.products/patch` | Makes changes to a Product resource. |