- [Resource: LineItemCreativeAssociation](https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#LineItemCreativeAssociation)
  - [JSON representation](https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#LineItemCreativeAssociation.SCHEMA_REPRESENTATION)
- [LineItemCreativeAssociationStatus](https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#LineItemCreativeAssociationStatus)
- [LineItemCreativeAssociationStats](https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#LineItemCreativeAssociationStats)
  - [JSON representation](https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#LineItemCreativeAssociationStats.SCHEMA_REPRESENTATION)
- [CreativeStats](https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#CreativeStats)
  - [JSON representation](https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#CreativeStats.SCHEMA_REPRESENTATION)
- [Methods](https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#METHODS_SUMMARY)

## Resource: LineItemCreativeAssociation

A LineItemCreativeAssociation associates a `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.creatives#Creative` or `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.creativeSets#CreativeSet` with a `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems#LineItem` so that the creative can be served in ad units targeted by the line item.

| JSON representation |
|---|
| ``` { "name": string, "sizes": [ { object (`https://developers.google.com/ad-manager/api/beta/reference/rest/v1/Size`) } ], "targetingDisplayName": string, "lineItem": string, "creative": string, "creativeSet": string, "status": enum (`https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#LineItemCreativeAssociationStatus`), "startTime": string, "endTime": string, "destinationUrl": string, "manualCreativeRotationWeight": number, "sequentialCreativeRotationIndex": integer, "updateTime": string, "stats": { object (`https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#LineItemCreativeAssociationStats`) } } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. The resource name of the `LineItemCreativeAssociation`. Format: `networks/{networkCode}/lineItems/{lineItemId}/creatives/{creativeId}` |
| `sizes[]` | ``object (`https://developers.google.com/ad-manager/api/beta/reference/rest/v1/Size`)`` Optional. Overrides the value set for `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.creatives#Creative.FIELDS.size` of the `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#LineItemCreativeAssociation.FIELDS.creative`, which allows the creative to be served to ad units that would otherwise not be compatible for its actual size. |
| `targetingDisplayName` | `string` Optional. Specifies creative targeting for this line item creative association. It should match the \[targetingName\]\[CreativePlaceholder.targeting_name\] specified on the corresponding \[creativePlaceholder\]\[LineItem.creative_placeholder\] on the `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#LineItemCreativeAssociation.FIELDS.line_item`. |
| `lineItem` | `string` Required. Immutable. The `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems#LineItem` to which the LineItemCreativeAssociation belongs. |
| `creative` | `string` Optional. Immutable. The `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.creatives#Creative` to which the LineItemCreativeAssociation associated. Optional if `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#LineItemCreativeAssociation.FIELDS.creative_set` is set. |
| `creativeSet` | `string` Optional. Immutable. The `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.creativeSets#CreativeSet` to which the LineItemCreativeAssociation associated. Optional if `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#LineItemCreativeAssociation.FIELDS.creative` is set. |
| `status` | ``enum (`https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#LineItemCreativeAssociationStatus`)`` Output only. The status of the association. |
| `startTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Optional. Overrides the value set for `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems#LineItem.FIELDS.start_time` of the `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#LineItemCreativeAssociation.FIELDS.line_item`. This value is only valid for Ad Manager 360 networks. If unset, the `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems#LineItem.FIELDS.start_time` of the `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#LineItemCreativeAssociation.FIELDS.line_item` will be used. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `endTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Optional. Overrides `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems#LineItem.FIELDS.end_time` of the `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#LineItemCreativeAssociation.FIELDS.line_item`. This value is only valid for Ad Manager 360 networks. If unset, the `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems#LineItem.FIELDS.end_time` of the `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#LineItemCreativeAssociation.FIELDS.line_item` will be used. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `destinationUrl` | `string` Optional. Overrides the value set for \[destinationUrl\]\[Creative.destination_url\] of the `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#LineItemCreativeAssociation.FIELDS.creative`. This value is only valid for Ad Manager 360 networks. |
| `manualCreativeRotationWeight` | `number` Optional. Non-empty default. The weight of the `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#LineItemCreativeAssociation.FIELDS.creative`. This value is only used if the `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems#LineItem.FIELDS.creative_rotation_type` of the `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#LineItemCreativeAssociation.FIELDS.line_item` is set to `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/CreativeRotationType#ENUM_VALUES.WEIGHTED`. Defaults to 10. |
| `sequentialCreativeRotationIndex` | `integer` Optional. Non-empty default. The sequential rotation index of the Creative. This value is used only if the `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#LineItemCreativeAssociation.FIELDS.line_item`'s `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems#LineItem.FIELDS.creative_rotation_type` is set to `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/CreativeRotationType#ENUM_VALUES.SEQUENTIAL`. Defaults to 1. |
| `updateTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The date and time this association was last modified. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `stats` | ``object (`https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#LineItemCreativeAssociationStats`)`` Output only. Contains trafficking statistics for the association. |

## LineItemCreativeAssociationStatus

Describes the status of the association.

| Enums ||
|---|---|
| `LINE_ITEM_CREATIVE_ASSOCIATION_STATUS_UNSPECIFIED` | Default value. This value is unused. |
| `ACTIVE` | The association is active and the associated Creative can be served. |
| `INACTIVE` | The association is inactive and the associated Creative is ineligible for being served. |

## LineItemCreativeAssociationStats

Contains statistics such as impressions, clicks delivered, and viewable impressions for a `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#LineItemCreativeAssociation`.

| JSON representation |
|---|
| ``` { "creativeSetStats": { string: { object (`https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#CreativeStats`) }, ... }, "impressionsDelivered": string, "clicksDelivered": string, "viewableImpressionsDelivered": string } ``` |

| Fields ||
|---|---|
| `creativeSetStats` | ``map (key: string (https://developers.google.com/discovery/v1/type-format format), value: object (`https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives#CreativeStats`))`` Output only. Creative set stats. |
| `impressionsDelivered` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. The number of impressions delivered. |
| `clicksDelivered` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. The number of clicks delivered. |
| `viewableImpressionsDelivered` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. The number of viewable impressions delivered. |

## CreativeStats

Contains statistics such as impressions, clicks delivered, and viewable impressions for creatives belonging to a `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.creativeSets#CreativeSet`.

| JSON representation |
|---|
| ``` { "impressionsDelivered": string, "clicksDelivered": string, "viewableImpressionsDelivered": string } ``` |

| Fields ||
|---|---|
| `impressionsDelivered` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. The number of impressions delivered. |
| `clicksDelivered` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. The number of clicks delivered. |
| `viewableImpressionsDelivered` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. The number of video completions delivered. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives/get` | Retrieves a `LineItemCreativeAssociation` object. |
| ### `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.lineItems.creatives/list` | Lists `LineItemCreativeAssociation` objects. |