# LineTerms

- [JSON representation](https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/LineTerms#SCHEMA_REPRESENTATION)
- [AdPlayPlan](https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/LineTerms#AdPlayPlan)
  - [JSON representation](https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/LineTerms#AdPlayPlan.SCHEMA_REPRESENTATION)
- [AdPlayPlanEntry](https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/LineTerms#AdPlayPlanEntry)
  - [JSON representation](https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/LineTerms#AdPlayPlanEntry.SCHEMA_REPRESENTATION)
- [Attribute](https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/LineTerms#Attribute)
  - [JSON representation](https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/LineTerms#Attribute.SCHEMA_REPRESENTATION)
- [AdPlayCount](https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/LineTerms#AdPlayCount)
  - [JSON representation](https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/LineTerms#AdPlayCount.SCHEMA_REPRESENTATION)

The seller guaranteed terms for this line.

| JSON representation |
|---|
| ``` { "billableEvents": string, "costPerBillableEvent": { object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/Shared.Types/Money`) }, "adPlayPlan": { object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/LineTerms#AdPlayPlan`) }, "attribute": [ { object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/LineTerms#Attribute`) } ] } ``` |

| Fields ||
|---|---|
| `billableEvents` | `string (https://developers.google.com/discovery/v1/type-format format)` Required. Total billable events based on the details of this line. |
| `costPerBillableEvent` | ``object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/Shared.Types/Money`)`` Required. Cost per billable event. |
| `adPlayPlan` | ``object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/LineTerms#AdPlayPlan`)`` Optional. The ad play plan for this line. |
| `attribute[]` | ``object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/LineTerms#Attribute`)`` A list of attributes for this line. |

## AdPlayPlan

An ad play plan for detailing when and where ad plays are planned to take place, as well as duration and number of billable events.

| JSON representation |
|---|
| ``` { "adPlayPlanEntries": [ { object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/LineTerms#AdPlayPlanEntry`) } ] } ``` |

| Fields ||
|---|---|
| `adPlayPlanEntries[]` | ``object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/LineTerms#AdPlayPlanEntry`)`` Required. The entries of this plan. |

## AdPlayPlanEntry

An entry to be included in the ad play plan.

Example:

    adUnit: adUnits/123,
    startDate: 1/1/19 10:00,
    endDate: 1/1/19/ 11:00,
    totalBillableEvents: 100,
    playDuration: 300s

The entry above specifies that the ad will play on the ad unit with the id 123, on the date 1/1/19 between 10:00 and 11:00 for a total of 300 seconds resulting in 100 billable events.

| JSON representation |
|---|
| ``` { "adUnit": string, "startTime": string, "endTime": string, "totalBillableEvents": string, "playDuration": string } ``` |

| Fields ||
|---|---|
| `adUnit` | `string` Required. The name of the `https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/adUnits#AdUnit` in this plan entry. Format = adUnits/123 |
| `startTime` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` format)`` Required. The start date and time for this plan entry (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` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` format)`` Required. The end date and time for this plan entry (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"`. |
| `totalBillableEvents` | `string (https://developers.google.com/discovery/v1/type-format format)` Required. Number of planned billable events between the specified start and end times. A billable event is either an impression or an ad play. |
| `playDuration` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration` format)`` Required. The total amount of time the ad will be visible for. A duration in seconds with up to nine fractional digits, terminated by '`s`'. Example: `"3.5s"`. |

## Attribute

An attribute of the element (e.g. ad play count) and its value.

| JSON representation |
|---|
| ``` { "adPlayCount": { object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/LineTerms#AdPlayCount`) } } ``` |

| Fields ||
|---|---|
| `adPlayCount` | ``object (`https://developers.google.com/display-video/out-of-home-seller/reference/rest/v1beta1/LineTerms#AdPlayCount`)`` |

## AdPlayCount

An estimated number of ad plays.

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

| Fields ||
|---|---|
| `value` | `string (https://developers.google.com/discovery/v1/type-format format)` |