List ad groups
GET {{baseUrl}}/ad_accounts/:ad_account_id/ad_groups?campaign_ids=84772&ad_group_ids=84772&entity_statuses=ACTIVE&entity_statuses=ACTIVE&page_size=25&order=ASCENDING&bookmark=aliqua adipisicing ad ullamco officia&translate_interests_to_names=false
Get a list of the ad groups in the specified adaccountid, filtered by the specified options.
- The token's user_account must either be the Owner of the specified ad account, or have one of the necessary roles granted to them via Business Access: Admin, Analyst, Campaign Manager.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
campaign_ids | number | List of Campaign Ids to use to filter the results. | |
ad_group_ids | number | List of Ad group Ids to use to filter the results. | |
entity_statuses | string | Entity status | |
entity_statuses | string | Entity status | |
page_size | number | Maximum number of items to include in a single page of the response. See documentation on <a href='/docs/api/v5/#tag/Pagination'>Pagination</a> for more information. | |
order | string | 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. | |||
bookmark | string | Cursor used to fetch the next page of items | |
translate_interests_to_names | boolean | Return interests as text names (if value is true) rather than topic IDs. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"items":[{"name":"Ad Group For Pin: 687195905986","status":"ACTIVE","budget_in_micro_currency":5000000,"bid_in_micro_currency":5000000,"budget_type":"LIFETIME","start_time":5686848000,"end_time":5705424000,"targeting_spec":{"et9d9":["in laboris aliquip tempor","consequat"],"exercitation_e4":["","est elit consectetur do"],"quis680":["magna sunt sit consectetur","magna ad i"]},"lifetime_frequency_cap":100,"tracking_urls":{"impression":["URL1","URL2"],"click":["URL1","URL2"],"engagement":["URL1","URL2"],"buyable_button":["URL1","URL2"],"audience_verification":["URL1","URL2"]},"auto_targeting_enabled":true,"placement_group":"ALL","pacing_delivery_type":"STANDARD","conversion_learning_mode_type":"ACTIVE","summary_status":"RUNNING","feed_profile_id":"626736533506","campaign_id":"626736533506","billable_event":"CLICKTHROUGH","id":"2680060704746","type":"ipsum","ad_account_id":"549755885175","created_time":1476477189,"updated_time":1476477189},{"name":"Ad Group For Pin: 687195905986","status":"ACTIVE","budget_in_micro_currency":5000000,"bid_in_micro_currency":5000000,"budget_type":"LIFETIME","start_time":5686848000,"end_time":5705424000,"targeting_spec":{"dolor_61":["consectetur sunt eiusmod aute","voluptate eu et"]},"lifetime_frequency_cap":100,"tracking_urls":{"impression":["URL1","URL2"],"click":["URL1","URL2"],"engagement":["URL1","URL2"],"buyable_button":["URL1","URL2"],"audience_verification":["URL1","URL2"]},"auto_targeting_enabled":true,"placement_group":"ALL","pacing_delivery_type":"STANDARD","conversion_learning_mode_type":"ACTIVE","summary_status":"RUNNING","feed_profile_id":"626736533506","campaign_id":"626736533506","billable_event":"CLICKTHROUGH","id":"2680060704746","type":"do nostrud proident aliqua","ad_account_id":"549755885175","created_time":1476477189,"updated_time":1476477189}],"bookmark":"Duis laboris adipisicing"}