type Placement (v202502)

  • A Placement is a grouping of related AdUnit objects.

  • Placements have a unique read-only id and placementCode assigned by Google upon creation.

  • Each Placement has a required name and an optional description.

  • The status of a Placement is read-only and can be ACTIVE, INACTIVE, or ARCHIVED.

  • A Placement contains a collection of AdUnit object IDs it targets, and a read-only lastModifiedDateTime.

A Placement groups related AdUnit objects.


Namespace
https://www.google.com/apis/ads/publisher/v202502

Field

SiteTargetingInfo (inherited)
Placement

id

xsd:long

Uniquely identifies the Placement. This attribute is read-only and is assigned by Google when a placement is created.

name

xsd:string

The name of the Placement. This value is required and has a maximum length of 255 characters.

description

xsd:string

A description of the Placement. This value is optional and its maximum length is 65,535 characters.

placementCode

xsd:string

A string used to uniquely identify the Placement for purposes of serving the ad. This attribute is read-only and is assigned by Google when a placement is created.

status

InventoryStatus

The status of the Placement. This attribute is read-only.


Enumerations
ACTIVE
The object is active.
INACTIVE
The object is no longer active.
ARCHIVED
The object has been archived.

targetedAdUnitIds

xsd:string[]

The collection of AdUnit object IDs that constitute the Placement.

lastModifiedDateTime

DateTime

The date and time this placement was last modified.