List ad groups
list_ad_groupsRead-only
Retrieve ad groups for a campaign by providing its ID. Supports cursor-based pagination to navigate through results.
Instructions
List ad groups within a campaign (campaign_id is required). Ad groups belong to a campaign and hold the bidding configuration and context hints. Supports cursor pagination (order, after/before; the response includes first_id, last_id, and has_more). Monetary values are expressed in micros: 1,000,000 micros = 1 unit of the account's currency (for example, $1.00 = 1,000,000 micros). Divide any *_micros value by 1,000,000 to show a human-readable amount, and multiply by 1,000,000 to convert a currency amount into micros.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| campaign_id | Yes | Parent campaign ID. Required — ad groups are listed within a campaign. | |
| limit | No | Maximum number of objects to return per page (1-500). Uses the API default if omitted. | |
| order | No | Sort by creation time: 'asc' for oldest-first, 'desc' for newest-first. | |
| after | No | Pagination cursor. Pass the `last_id` from the previous page to fetch the next page. | |
| before | No | Pagination cursor. Pass the `first_id` from the previous page to fetch the previous page. |