Skip to main content
PUT
/
api
/
v1
/
campaigns
/
drafts
/
{draft_id}
/
ad-groups
/
{ad_group_id}
Update an ad group
curl --request PUT \
  --url http://localhost:8000/api/v1/campaigns/drafts/{draft_id}/ad-groups/{ad_group_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "cpc_bid_micros": 123
}
'
{
  "id": 123,
  "name": "<string>",
  "cpc_bid_micros": 25000000000,
  "keywords": [
    {
      "id": 123,
      "text": "<string>",
      "match_type": "EXACT",
      "cpc_bid_micros": 25000000000,
      "final_url": "<string>",
      "source_market_analysis_keyword_id": 123
    }
  ],
  "rsas": [
    {
      "id": 123,
      "ad_group_id": 123,
      "headlines": [
        {
          "text": "<string>",
          "pinned_field": "HEADLINE_1",
          "reason": "<string>"
        }
      ],
      "descriptions": [
        {
          "text": "<string>",
          "pinned_field": "HEADLINE_1",
          "reason": "<string>"
        }
      ],
      "final_url": "<string>",
      "final_mobile_url": "<string>",
      "display_path_1": "<string>",
      "display_path_2": "<string>",
      "tracking_url_template": "<string>",
      "generation_status": "pending",
      "generation_task_id": "<string>",
      "generation_error": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

draft_id
integer
required
ad_group_id
integer
required

Query Parameters

regenerate_rsas
boolean
default:true

Auto-regenerate RSAs if name changed

Body

application/json

Request to update an ad group.

name
string | null
Required string length: 1 - 256
cpc_bid_micros
integer | null

Response

Successful Response

Ad group within a campaign draft.

id
integer
required
name
string
required
cpc_bid_micros
integer | null
Required range: 0 <= x <= 50000000000
keywords
CampaignDraftKeywordSchema · object[]
rsas
CampaignDraftRSASchema · object[]