type Placement (v202508)

  • A Placement is a service object that groups related AdUnit objects.

  • The PlacementService allows for creating and updating Placement objects.

  • Key attributes of a Placement include its unique ID, name, description, placement code, status, targeted AdUnit IDs, and last modified date/time.

  • The Placement object inherits from SiteTargetingInfo.
Service
PlacementService
Dependencies
PlacementPage createPlacements() updatePlacements()
▼
Placement
Inheritance
SiteTargetingInfo
▼
Placement

A Placement groups related AdUnit objects.

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

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.