# REST Resource: sellers.products

- [Resource: Product](https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1/sellers.products#Product)
  - [JSON representation](https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1/sellers.products#Product.SCHEMA_REPRESENTATION)
- [State](https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1/sellers.products#State)
- [Methods](https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1/sellers.products#METHODS_SUMMARY)

## Resource: Product

A single product.

| JSON representation |
|---|
| ``` { "name": string, "externalId": string, "displayName": string, "description": string, "labels": { string: string, ... }, "creativeSpecifications": [ { object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1/CreativeSpecification`) } ], "bookingLeadDuration": string, "assignmentLeadDuration": string, "minFlightDuration": string, "maxFlightDuration": string, "slotDuration": string, "createTime": string, "updateTime": string, "state": enum (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1/sellers.products#State`), "currencyCode": string } ``` |

| Fields ||
|---|---|
| `name` | `string` The resource name of the product in the format: `sellers/{seller}/products/{product}`. For example `sellers/seller111/products/product123`. |
| `externalId` | `string` An id used to map this entity to external sources. |
| `displayName` | `string` Required. The display name of the product. Must be UTF-8 encoded with a maximum size of 240 bytes. |
| `description` | `string` Additional freeform field to describe the product. |
| `labels` | `map (key: string, value: string)` The set of freeform labels to describe this product. An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |
| `creativeSpecifications[]` | ``object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1/CreativeSpecification`)`` Required. List of permissible creatives that can be served for this product. |
| `bookingLeadDuration` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration` format)`` Required. Lead duration required to book the product. Now + bookingLeadDuration should be after flight start. A duration in seconds with up to nine fractional digits, terminated by '`s`'. Example: `"3.5s"`. |
| `assignmentLeadDuration` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration` format)`` Required. Lead duration required to assign creatives. A duration in seconds with up to nine fractional digits, terminated by '`s`'. Example: `"3.5s"`. |
| `minFlightDuration` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration` format)`` Minimum flight duration for this product. A duration in seconds with up to nine fractional digits, terminated by '`s`'. Example: `"3.5s"`. |
| `maxFlightDuration` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration` format)`` Required. Maximum flight duration for this product. A duration in seconds with up to nine fractional digits, terminated by '`s`'. Example: `"3.5s"`. |
| `slotDuration` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration` format)`` Required. Slot duration for this product. A duration in seconds with up to nine fractional digits, terminated by '`s`'. Example: `"3.5s"`. |
| `createTime` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` format)`` Output only. Creation timestamp for the product. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: `"2014-10-02T15:01:23Z"` and `"2014-10-02T15:01:23.045123456Z"`. |
| `updateTime` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` format)`` Output only. Last updated timestamp for the product. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: `"2014-10-02T15:01:23Z"` and `"2014-10-02T15:01:23.045123456Z"`. |
| `state` | ``enum (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1/sellers.products#State`)`` Output only. The state of this product. |
| `currencyCode` | `string` Required. The 3-letter uppercase currency code defined in ISO 4217. |

## State

Possible values for product state.

| Enums ||
|---|---|
| `STATE_UNSPECIFIED` | Default value when Product State is not specified or is unknown in this version. |
| `STATE_ACTIVE` | Product is active. |
| `STATE_DELETED` | Product is deleted. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1/sellers.products/create` | Creates a new product. |
| ### `https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1/sellers.products/delete` | Deletes an existing product. |
| ### `https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1/sellers.products/get` | Retrieves an individual product. |
| ### `https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1/sellers.products/list` | Lists products. |
| ### `https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1/sellers.products/patch` | Updates an existing product. |