Overview

Ad Group APIs let partners create, review, update, and manage ad groups within a campaign. Ad groups define how ads are delivered, including targeting, bidding, scheduling, and lifecycle status.

Create or review

Create a new ad group or retrieve an existing one.

Configure delivery

Set targeting, bidding, budget, and schedule behavior.

Associate creative

Review or manage attached creatives. Set landing pages. Associate click and impression trackers, if needed.

Manage status

Pause, resume, archive, or unarchive the ad group.

Validate readiness

Confirm the ad group is configured correctly for delivery.

Common workflows

Review an ad group
Use the list APIs to review ad group configuration, lifecycle status, and creative associations before making changes.
Create an ad group
Create an ad group within a campaign and configure targeting, bidding, budget, and schedule placement.
Update an ad group
Use PUT when you need full-object replacement and PATCH when you need to update selected fields.
Change ad group status
Use the status endpoint to pause, resume, archive, or unarchive ad groups. This changes delivery state rather than configuration.
Review creative associations
Use the creative-association list endpoint to verify which creatives, landing pages, tracker settings, badges, price display settings, and associated items are attached to the ad group.