Skip to main content
PATCH
Update campaign settings (step 1)

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

Query Parameters

update_all_keywords_match_type
boolean
default:false

When default_match_type changes: True = update ALL keywords, False (default) = only update keywords that had the previous match type

Body

application/json

Request schema for PATCH /drafts/{id}/campaign-settings.

All fields optional — only provided fields are updated.

name
string | null
Required string length: 1 - 256
campaign_name
string | null
Required string length: 1 - 256
website_url
string<uri> | null
Required string length: 1 - 2083
daily_budget_micros
integer | null
bidding_strategy
BiddingStrategySchema · object | null

Bidding strategy configuration.

default_match_type
enum<string> | null

The keyword match types.

Available options:
EXACT,
PHRASE,
BROAD,
BROAD_MODIFIER,
NEGATIVE
language_ids
integer[] | null
location_targets
LocationTargetSchema · object[] | null
network_settings
NetworkSettingsSchema · object | null

Network settings for campaign.

ad_schedule
AdScheduleSchema · object | null

Ad schedule configuration.

start_date
string<date> | null
end_date
string<date> | null
conversion_goals
ConversionGoalSchema · object[] | null

Response

Successful Response

Shared response for all 4 step PATCH endpoints.

Returns the full refreshed draft plus any validation warnings for that step.

draft
CampaignDraftSchema · object
required

Campaign draft schema - full representation.

warnings
ValidationErrorSchema · object[]