REST Resource: networks.placements

Resource: Placement

The Placement resource.

JSON representation
{
  "name": string,
  "placementId": string,
  "targetedAdUnits": [
    string
  ],
  "displayName": string,
  "description": string,
  "placementCode": string,
  "status": enum (PlacementStatus),
  "updateTime": string
}
Fields
name

string

Identifier. The resource name of the Placement. Format: networks/{networkCode}/placements/{placementId}

placementId

string (int64 format)

Output only. 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 (PlacementStatus)

Output only. The status of the Placement.

updateTime

string (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

batchActivate

Activates a list of Placement objects.

batchArchive

Archives a list of Placement objects.

batchCreate

API to batch create Placement objects.

batchDeactivate

Deactivates a list of Placement objects.

batchUpdate

API to batch update Placement objects.

create

API to create an Placement object.

get

API to retrieve a Placement object.

list

API to retrieve a list of Placement objects.

patch

API to update an Placement object.