type Placement (v202505)

  • A Placement is a grouping of related AdUnit objects.

  • Placements have unique identifiers (id, placementCode) assigned by Google and required names.

  • Placements have a status that can be active, inactive, or archived.

  • Placements target a collection of AdUnit object IDs.

  • Placements also have a last modified date and time.
Service
PlacementService
Dependencies
PlacementPage createPlacements() updatePlacements()
▼
Placement
Inheritance
SiteTargetingInfo
▼
Placement

A Placement groups related AdUnit objects.

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

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.