# REST Resource: availabilityOrders.availabilityLines

- [Resource: AvailabilityLine](https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/availabilityOrders.availabilityLines#AvailabilityLine)
  - [JSON representation](https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/availabilityOrders.availabilityLines#AvailabilityLine.SCHEMA_REPRESENTATION)
- [State](https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/availabilityOrders.availabilityLines#State)
- [Methods](https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/availabilityOrders.availabilityLines#METHODS_SUMMARY)

## Resource: AvailabilityLine

An availability line represents a set of settings for which the buyer requests inventory availability and the response from the seller. For workflow see `https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/availabilityOrders#AvailabilityOrder`.

| JSON representation |
|---|
| ``` { "name": string, "product": string, "startTime": string, "endTime": string, "startDate": { object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/Shared.Types/Date`) }, "endDate": { object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/Shared.Types/Date`) }, "budget": { object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/Shared.Types/Money`) }, "targeting": { object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/Targeting`) }, "availabilityLineTerms": { object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/LineTerms`) }, "state": enum (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/availabilityOrders.availabilityLines#State`), "rejection": { object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/Rejection`) }, "createTime": string, "updateTime": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Output only. The resource name of the availability line in the format: `availabilityOrders/123/availabilityLines/321`. |
| `product` | `string` Output only. The name of the `https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/products#Product` this availability request is for. Format = products/456 |
| `startTime (deprecated)` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` format)`` > [!WARNING] > This item is deprecated! Output only. The start time of when the availability is requested (inclusive). 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"`. |
| `endTime (deprecated)` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` format)`` > [!WARNING] > This item is deprecated! Output only. The end time of when the availability is requested (exclusive). 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"`. |
| `startDate` | ``object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/Shared.Types/Date`)`` Output only. The start date of when the availability is requested (inclusive). Same time zone as the ad unit. |
| `endDate` | ``object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/Shared.Types/Date`)`` Output only. The end date of when the availability is requested (inclusive). Same time zone as the ad unit. |
| `budget` | ``object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/Shared.Types/Money`)`` Output only. The budget of the availability line. |
| `targeting` | ``object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/Targeting`)`` Output only. The targeting for which the availability is requested. |
| `availabilityLineTerms` | ``object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/LineTerms`)`` Output only. Seller can use the \[Complete\]\[google.ads.xbid.outofhome.v1beta1.OrderManagementService.CompleteAvailabilityLine\] to update \[LineTerms\]. |
| `state` | ``enum (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/availabilityOrders.availabilityLines#State`)`` Output only. The state of this availability order. See `https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/availabilityOrders.availabilityLines#State` for the lifecycle of an AvailabilityLine. Seller can use the \[Complete\]\[google.ads.xbid.outofhome.v1beta1.OrderManagementService.CompleteAvailabilityLine\] or \[Reject\]\[google.ads.xbid.outofhome.v1beta1.OrderManagementService.RejectAvailabilityLine\] custom methods to set to one of: - `STATE_COMPLETED` - `STATE_REJECTED` respectively. |
| `rejection` | ``object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/Rejection`)`` Rejection details for the availability line. |
| `createTime` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` format)`` Output only. Creation timestamp for the availability line. 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 availability line. 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

Possible values for availability line state.

| Enums ||
|---|---|
| `STATE_UNSPECIFIED` | The default value when availability line state has not been specified or is unknown in this version. |
| `STATE_PENDING` | Pending availability when the buyer provided the availability request settings. |
| `STATE_COMPLETED` | Completed state when the seller provided the availability response. |
| `STATE_REJECTED` | Rejection state when the availability line has been disapproved by the seller. Disapproval details must be provided. |
| `STATE_CANCELLED` | Cancelled state when buyer cancel the order before seller complete or reject availability response. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/availabilityOrders.availabilityLines/complete` | Marks an existing availability line as complete. |
| ### `https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/availabilityOrders.availabilityLines/get` | Retrieves an individual line for an availability order. |
| ### `https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/availabilityOrders.availabilityLines/list` | Lists lines for an availability order. |
| ### `https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/availabilityOrders.availabilityLines/reject` | Marks an existing availability line as rejected. |