- [Resource: Placement](https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.placements#Placement)
  - [JSON representation](https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.placements#Placement.SCHEMA_REPRESENTATION)
- [PlacementStatus](https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.placements#PlacementStatus)
- [Methods](https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.placements#METHODS_SUMMARY)

## Resource: Placement

The `Placement` resource.

| JSON representation |
|---|
| ``` { "name": string, "placementId": string, "targetedAdUnits": [ string ], "displayName": string, "description": string, "placementCode": string, "status": enum (`https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.placements#PlacementStatus`), "updateTime": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. The resource name of the `Placement`. Format: `networks/{networkCode}/placements/{placementId}` |
| `placementId (deprecated)` | `string (https://developers.google.com/discovery/v1/type-format format)` > [!WARNING] > Output only. Parse the ID from the `name` field instead. Output only. Deprecated: `Placement` ID. |
| `targetedAdUnits[]` | `string` Optional. The resource names of AdUnits that constitute the Placement. Format: "networks/{networkCode}/adUnits/{adUnit}" |
| `displayName` | `string` Required. The display name of the placement. This attribute has a maximum length of 255 characters. |
| `description` | `string` Optional. A description of the Placement. This attribute has a maximum length of 65,535 characters. |
| `placementCode` | `string` Output only. A string used to uniquely identify the Placement for purposes of serving the ad. This attribute is assigned by Google. |
| `status` | ``enum (`https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.placements#PlacementStatus`)`` Output only. The status of the Placement. |
| `updateTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The instant this Placement 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"`. |

## PlacementStatus

Status of the placement.

| Enums ||
|---|---|
| `PLACEMENT_STATUS_UNSPECIFIED` | Not specified value. |
| `ACTIVE` | Stats are collected, user-visible. |
| `INACTIVE` | No stats collected, not user-visible. |
| `ARCHIVED` | No stats collected, user-visible. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.placements/batchActivate` | Activates a list of `Placement` objects. |
| ### `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.placements/batchArchive` | Archives a list of `Placement` objects. |
| ### `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.placements/batchCreate` | Creates `Placement` objects. |
| ### `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.placements/batchDeactivate` | Deactivates a list of `Placement` objects. |
| ### `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.placements/batchUpdate` | Batch updates `Placement` objects. |
| ### `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.placements/create` | Creates an `Placement` object. |
| ### `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.placements/get` | Retrieves a `Placement` object. |
| ### `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.placements/list` | Lists `Placement` objects. |
| ### `https://developers.google.com/ad-manager/api/beta/reference/rest/v1/networks.placements/patch` | Updates an `Placement` object. |