v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB
ad_groups

List of ad groups using promotions IDs.

Get a list of ad groups that are associated with those promotion ids

get/ad_accounts/{ad_account_id}/promotion_applied_entities

Path parameters

ad_account_idstring required

Unique identifier of an ad account.

Query parameters

bookmarkstring

Cursor used to fetch the next page of items

page_sizeinteger

Maximum number of items to include in a single page. See documentation on Pagination for more information.

order'ASCENDING' | 'DESCENDING'

The order in which to sort the items returned: "ASCENDING" or "DESCENDING" by ID. Note that higher-value IDs are associated with more-recently added items.

promotion_idsstring[] required

List of Promotion IDs to use to filter the results.

Response

The request has succeeded.

bookmarkstring nullable

Example response

{
  "items": [
    {
      "billable_event": "CLICKTHROUGH",
      "placement_group": "ALL",
      "status": "ACTIVE",
      "targeting_spec": {
        "SHOPPING_RETARGETING": [
          {
            "lookback_window": 30,
            "exclusion_window": 14,
            "tag_types": [
              0,
              6
            ]
          }
        ]
      },
      "tracking_urls": {
        "impression": [
          "URL1",
          "URL2"
        ],
        "click": [
          "URL1",
          "URL2"
        ],
        "engagement": [
          "URL1",
          "URL2"
        ],
        "buyable_button": [
          "URL1",
          "URL2"
        ],
        "audience_verification": [
          "URL1",
          "URL2"
        ]
      }
    }
  ]
}