type Placement (v202408)
Stay organized with collections
Save and categorize content based on your preferences.
A Placement groups related AdUnit objects.
- Namespace
-
https://www.google.com/apis/ads/publisher/v202408
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.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-06 UTC.
[null,null,["Last updated 2025-08-06 UTC."],[[["\u003cp\u003eA \u003ccode\u003ePlacement\u003c/code\u003e in Google Ad Manager serves as a container for grouping related \u003ccode\u003eAdUnit\u003c/code\u003e objects, streamlining ad serving and management.\u003c/p\u003e\n"],["\u003cp\u003eEach \u003ccode\u003ePlacement\u003c/code\u003e is uniquely identified by an ID and a placement code, both assigned by Google upon creation, and requires a name for identification.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ePlacement\u003c/code\u003e properties include a description, status (active, inactive, or archived), a list of targeted \u003ccode\u003eAdUnit\u003c/code\u003e IDs, and the last modified date and time.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage \u003ccode\u003ePlacements\u003c/code\u003e through the \u003ccode\u003ePlacementService\u003c/code\u003e, using methods like \u003ccode\u003ecreatePlacements()\u003c/code\u003e and \u003ccode\u003eupdatePlacements()\u003c/code\u003e to add or modify them.\u003c/p\u003e\n"]]],["The `PlacementService` allows for the management of `Placement` objects, which group related `AdUnit` objects. Key actions include `createPlacements()` and `updatePlacements()`. `Placement` objects have attributes like `id`, `name`, `description`, `placementCode`, and `status` (which can be `ACTIVE`, `INACTIVE`, or `ARCHIVED`). Each placement contains `targetedAdUnitIds` and includes a `lastModifiedDateTime`. A placement also inherits `SiteTargetingInfo`. The `name` is a required field with a max of 255 characters.\n"],null,["# type Placement (v202408)\n\n**Service** \n**PlacementService** **Dependencies** \n[PlacementPage](/ad-manager/api/reference/v202408/PlacementService.PlacementPage) [createPlacements()](/ad-manager/api/reference/v202408/PlacementService#createPlacements) [updatePlacements()](/ad-manager/api/reference/v202408/PlacementService#updatePlacements) \n▼\n**Placement** **Inheritance** \n[SiteTargetingInfo](/ad-manager/api/reference/v202408/PlacementService.SiteTargetingInfo) \n▼\n**Placement**\n\nA `Placement` groups related `AdUnit` objects.\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202408`\n\n| Field ----- ||\n|----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **`SiteTargetingInfo` (inherited)** ||\n| **`Placement`** ||\n| ### `id` | ` `xsd:`long` Uniquely identifies the `Placement`. This attribute is read-only and is assigned by Google when a placement is created. |\n| ### `name` | ` `xsd:`string` The name of the `Placement`. This value is required and has a maximum length of 255 characters. |\n| ### `description` | ` `xsd:`string` A description of the `Placement`. This value is optional and its maximum length is 65,535 characters. |\n| ### `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. |\n| ### `status` | ` `[InventoryStatus](/ad-manager/api/reference/v202408/PlacementService.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. \u003cbr /\u003e |\n| ### `targetedAdUnitIds` | ` `xsd:`string[]` The collection of `AdUnit` object IDs that constitute the `Placement`. |\n| ### `lastModifiedDateTime` | ` `[DateTime](/ad-manager/api/reference/v202408/PlacementService.DateTime)` ` The date and time this placement was last modified. |"]]
