- [Resource: PlacementGroup](https://developers.google.com/doubleclick-advertisers/rest/v5/placementGroups#PlacementGroup)
  - [JSON representation](https://developers.google.com/doubleclick-advertisers/rest/v5/placementGroups#PlacementGroup.SCHEMA_REPRESENTATION)
- [PlacementGroupType](https://developers.google.com/doubleclick-advertisers/rest/v5/placementGroups#PlacementGroupType)
- [Methods](https://developers.google.com/doubleclick-advertisers/rest/v5/placementGroups#METHODS_SUMMARY)

## Resource: PlacementGroup

Contains properties of a [package or roadblock](https://support.google.com/dcm/answer/2829217).

| JSON representation |
|---|
| ``` { "id": string, "accountId": string, "subaccountId": string, "advertiserId": string, "campaignId": string, "name": string, "siteId": string, "directorySiteId": string, "kind": string, "pricingSchedule": { object (`https://developers.google.com/doubleclick-advertisers/rest/v5/PricingSchedule`) }, "placementGroupType": enum (`https://developers.google.com/doubleclick-advertisers/rest/v5/placementGroups#PlacementGroupType`), "contentCategoryId": string, "placementStrategyId": string, "comment": string, "childPlacementIds": [ string ], "primaryPlacementId": string, "lastModifiedInfo": { object (`https://developers.google.com/doubleclick-advertisers/rest/v5/LastModifiedInfo`) }, "idDimensionValue": { object (`https://developers.google.com/doubleclick-advertisers/rest/v5/DimensionValue`) }, "advertiserIdDimensionValue": { object (`https://developers.google.com/doubleclick-advertisers/rest/v5/DimensionValue`) }, "campaignIdDimensionValue": { object (`https://developers.google.com/doubleclick-advertisers/rest/v5/DimensionValue`) }, "siteIdDimensionValue": { object (`https://developers.google.com/doubleclick-advertisers/rest/v5/DimensionValue`) }, "directorySiteIdDimensionValue": { object (`https://developers.google.com/doubleclick-advertisers/rest/v5/DimensionValue`) }, "primaryPlacementIdDimensionValue": { object (`https://developers.google.com/doubleclick-advertisers/rest/v5/DimensionValue`) }, "externalId": string, "createInfo": { object (`https://developers.google.com/doubleclick-advertisers/rest/v5/LastModifiedInfo`) }, "activeStatus": enum (`https://developers.google.com/doubleclick-advertisers/rest/v5/PlacementActiveStatus`) } ``` |

| Fields ||
|---|---|
| `id` | `string (https://developers.google.com/discovery/v1/type-format format)` ID of this placement group. This is a read-only, auto-generated field. |
| `accountId` | `string (https://developers.google.com/discovery/v1/type-format format)` Account ID of this placement group. This is a read-only field that can be left blank. |
| `subaccountId` | `string (https://developers.google.com/discovery/v1/type-format format)` Subaccount ID of this placement group. This is a read-only field that can be left blank. |
| `advertiserId` | `string (https://developers.google.com/discovery/v1/type-format format)` Advertiser ID of this placement group. This is a required field on insertion. |
| `campaignId` | `string (https://developers.google.com/discovery/v1/type-format format)` Campaign ID of this placement group. This field is required on insertion. |
| `name` | `string` Name of this placement group. This is a required field and must be less than 256 characters long. |
| `siteId` | `string (https://developers.google.com/discovery/v1/type-format format)` Site ID associated with this placement group. On insert, you must set either this field or the `directorySiteId` field to specify the site associated with this placement group. This is a required field that is read-only after insertion. |
| `directorySiteId` | `string (https://developers.google.com/discovery/v1/type-format format)` Directory site ID associated with this placement group. On insert, you must set either this field or the `siteId` field to specify the site associated with this placement group. This is a required field that is read-only after insertion. |
| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string `"dfareporting#placementGroup"`. |
| `pricingSchedule` | ``object (`https://developers.google.com/doubleclick-advertisers/rest/v5/PricingSchedule`)`` Pricing schedule of this placement group. This field is required on insertion. |
| `placementGroupType` | ``enum (`https://developers.google.com/doubleclick-advertisers/rest/v5/placementGroups#PlacementGroupType`)`` Type of this placement group. A package is a simple group of placements that acts as a single pricing point for a group of tags. A roadblock is a group of placements that not only acts as a single pricing point, but also assumes that all the tags in it will be served at the same time. A roadblock requires one of its assigned placements to be marked as primary for reporting. This field is required on insertion. |
| `contentCategoryId` | `string (https://developers.google.com/discovery/v1/type-format format)` ID of the content category assigned to this placement group. |
| `placementStrategyId` | `string (https://developers.google.com/discovery/v1/type-format format)` ID of the placement strategy assigned to this placement group. |
| `comment` | `string` Comments for this placement group. |
| `childPlacementIds[]` | `string (https://developers.google.com/discovery/v1/type-format format)` IDs of placements which are assigned to this placement group. This is a read-only, auto-generated field. |
| `primaryPlacementId` | `string (https://developers.google.com/discovery/v1/type-format format)` ID of the primary placement, used to calculate the media cost of a roadblock (placement group). Modifying this field will automatically modify the `primary` field on all affected roadblock child placements. |
| `lastModifiedInfo` | ``object (`https://developers.google.com/doubleclick-advertisers/rest/v5/LastModifiedInfo`)`` Information about the most recent modification of this placement group. This is a read-only field. |
| `idDimensionValue` | ``object (`https://developers.google.com/doubleclick-advertisers/rest/v5/DimensionValue`)`` Dimension value for the ID of this placement group. This is a read-only, auto-generated field. |
| `advertiserIdDimensionValue` | ``object (`https://developers.google.com/doubleclick-advertisers/rest/v5/DimensionValue`)`` Dimension value for the ID of the advertiser. This is a read-only, auto-generated field. |
| `campaignIdDimensionValue` | ``object (`https://developers.google.com/doubleclick-advertisers/rest/v5/DimensionValue`)`` Dimension value for the ID of the campaign. This is a read-only, auto-generated field. |
| `siteIdDimensionValue` | ``object (`https://developers.google.com/doubleclick-advertisers/rest/v5/DimensionValue`)`` Dimension value for the ID of the site. This is a read-only, auto-generated field. |
| `directorySiteIdDimensionValue` | ``object (`https://developers.google.com/doubleclick-advertisers/rest/v5/DimensionValue`)`` Dimension value for the ID of the directory site. This is a read-only, auto-generated field. |
| `primaryPlacementIdDimensionValue` | ``object (`https://developers.google.com/doubleclick-advertisers/rest/v5/DimensionValue`)`` Dimension value for the ID of the primary placement. This is a read-only, auto-generated field. |
| `externalId` | `string` External ID for this placement. |
| `createInfo` | ``object (`https://developers.google.com/doubleclick-advertisers/rest/v5/LastModifiedInfo`)`` Information about the creation of this placement group. This is a read-only field. |
| `activeStatus` | ``enum (`https://developers.google.com/doubleclick-advertisers/rest/v5/PlacementActiveStatus`)`` Whether this placement group is active, inactive, archived or permanently archived. |

## PlacementGroupType

| Enums ||
|---|---|
| `PLACEMENT_PACKAGE` | A simple group of site-placements (tags). Basically acts as a single pricing point for a group of tags. |
| `PLACEMENT_ROADBLOCK` | A group of site-placements (tags) that not only acts as a single pricing point but also assumes that all the tags in it will be served at the same time. This kind of group requires one of its assigned site-placements to be marked as primary for reporting purposes. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/doubleclick-advertisers/rest/v5/placementGroups/get` | Gets one placement group by ID. |
| ### `https://developers.google.com/doubleclick-advertisers/rest/v5/placementGroups/insert` | Inserts a new placement group. |
| ### `https://developers.google.com/doubleclick-advertisers/rest/v5/placementGroups/list` | Retrieves a list of placement groups, possibly filtered. |
| ### `https://developers.google.com/doubleclick-advertisers/rest/v5/placementGroups/patch` | Updates an existing placement group. |
| ### `https://developers.google.com/doubleclick-advertisers/rest/v5/placementGroups/update` | Updates an existing placement group. |