Google AdsVersion: v3

Upsert Google campaign

PUT/ad-publishing/google/ads

Create or update a full Google Ads campaign structure

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:adPublishing.write

Auth methods:OAuthPrivate Integration

Token type:Sub-Account Token

Request

Headers

Versionstringrequired

API Version

Available optionsv3

Example:v3

Body

application/json

idstring

Campaign identifier

Example:camp_abc123

namestringrequired

Campaign name

Example:My Campaign

locationIdstringrequired

Location identifier

Example:loc_abc123

advertisingChannelTypestringrequired

Advertising channel. Only SEARCH and DEMAND_GEN campaigns can be built and published by this product; the other Google channels are readable on existing campaigns but cannot be created here.

Available optionsSEARCHDEMAND_GEN

Example:SEARCH

advertisingChannelSubTypestring

Channel sub type

Available optionsDEMAND_GEN

Example:DEMAND_GEN

goalTypestring

Goal type

Available optionsWEBSITE_TRAFFICLEAD

Example:WEBSITE_TRAFFIC

budgetobject

Campaign budget

audienceobject

Campaign audience targeting

audience.localesobject[]required

Language targeting

audience.geoLocationsobject[]required

Geographic targeting

audience.geoLocations[].keystring

Geo target constant resource name

Example:geoTargetConstants/2840

audience.geoLocations[].idstring

Location identifier (place_id)

Example:ChIJOwg_06VPwokRYv534QaPC8g

audience.geoLocations[].namestring

Location display name

Example:New York

audience.geoLocations[].countryNamestring

Country name

Example:United States

audience.geoLocations[].typestring

Location type (city, region, country, address, etc.)

Example:city

audience.geoLocations[].radiusnumber

Radius for proximity targeting

Example:25

audience.geoLocations[].radiusUnitstring

Radius unit

Available optionskmmi

Example:mi

audience.geoLocations[].selectionTypestring

Include or exclude this location

Available optionsincludeexclude

Example:include

audience.geoLocations[].resourceNamestring

Google Ads resource name

Example:customers/123/geoTargetConstants/2840

audience.geoLocations[].placeIdstring

Google place ID

Example:ChIJOwg_06VPwokRYv534QaPC8g

audience.geoLocations[].formattedAddressstring

Full formatted address string

Example:New York, NY, USA

audience.geoLocations[].geometryobject

Geometry data from Google Geocoding API

audience.geoLocations[].addressComponentsobject[]

Address components from Google Geocoding API

audience.genderobject[]

Gender targeting

audience.ageRangeobject[]

Age range targeting

audience.segmentsstring[]

Audience segment resource names

Example:["customers/6776452901/userLists/9215680180"]

audience.targetInterestsobject

Affinity and in-market interests

networkSettingsobject

Network settings

biddingStrategyobject

Bidding strategy config

assetsobject

Campaign assets

isEuPoliticalAdsboolean

EU political ads flag

Example:false

adGroupsobject[]

Campaign ad groups

adGroups[].idstring

Ad group identifier

Example:ag_abc123

adGroups[].adGroupIdstring

Google ad group identifier

Example:customers/123/adGroups/456

adGroups[].namestring

Ad group name

Example:Ad Group 1

adGroups[].adCampaignIdstring

Ad campaign identifier

Example:camp_abc123

adGroups[].adContentobject[]

Ad content items

adGroups[].adContent[].idstring

Ad identifier

Example:ad_abc123

adGroups[].adContent[].namestring

Ad name

Example:Summer Sale Ad

adGroups[].adContent[].mediaTypestring

Media type

Available optionsIMAGEVIDEOCAROUSEL

Example:IMAGE

adGroups[].adContent[].headlinesstring[]

Ad headlines

Example:["Buy Now","Best Deals"]

adGroups[].adContent[].longHeadlinesstring[]

Long headlines

Example:["Discover Great Deals Today"]

adGroups[].adContent[].descriptionsstring[]

Ad descriptions

Example:["Great products"]

adGroups[].adContent[].finalUrlstring

Final URL

Example:https://example.com

adGroups[].adContent[].path1string

Display path 1

Example:products

adGroups[].adContent[].path2string

Display path 2

Example:deals

adGroups[].adContent[].isDeletedboolean

Whether the ad is soft-deleted

Example:false

adGroups[].adContent[].adErrorstring

Ad-level error message from Google

Example:Landing page URL is invalid

adGroups[].adContent[].publishingStatusstring

Ad publishing status

Available optionsDRAFTSCHEDULEDPUBLISHEDPUBLISHINGFAILEDIN_REVIEWPAUSEDARCHIVEDWITH_ISSUESREJECTED

Example:PUBLISHED

adGroups[].adContent[].adIdstring

Internal ad identifier

Example:ad_internal_abc

adGroups[].adContent[].adCampaignIdstring

Ad campaign identifier

Example:camp_abc123

adGroups[].adContent[].adGroupIdstring

Ad group identifier

Example:ag_abc123

adGroups[].adContent[].googleAdIdstring

Google Ads ad resource ID

Example:customers/123/ads/456

adGroups[].adContent[].mediaobject[]

Ad media items

adGroups[].adContent[].callToActionLabelstring

Call to action label

Available optionsAUTOMATEDLEARN_MOREGET_QUOTEAPPLY_NOWSIGN_UPCONTACT_USSUBSCRIBEDOWNLOADBOOK_NOWSHOP_NOWBUY_NOWDONATE_NOW

Example:LEARN_MORE

adGroups[].adContent[].businessNamestring

Business name

Example:Acme Corp

adGroups[].adContent[].youtubeVideoLinksobject[]

YouTube video links

adGroups[].adContent[].carouselCardsobject[]

Carousel cards

adGroups[].adContent[].placementsstring[]

Channel placements

Available optionsGMAILYOUTUBE_IN_STREAMYOUTUBE_SHORTSYOUTUBE_IN_FEEDDISCOVERDISPLAY

Example:["YOUTUBE_IN_STREAM"]

adGroups[].adContent[].customChannelsboolean

Custom channels flag

Example:false

adGroups[].keywordsobject

Keyword targeting

adGroups[].publishingStatusstring

Ad group publishing status

Available optionsDRAFTSCHEDULEDPUBLISHEDPUBLISHINGFAILEDIN_REVIEWPAUSEDARCHIVEDWITH_ISSUESREJECTED

Example:PUBLISHED

adGroups[].adGroupErrorstring

Ad group-level error from Google

Example:Keyword policy violation

adGroups[].googleAdGroupIdstring

Google Ads ad group resource ID

Example:customers/123/adGroups/456

adGroups[].customChannelsboolean

Custom channels flag

Example:false

adGroups[].selectedChannelsstring[]

Selected channel placements

Available optionsGMAILYOUTUBE_IN_STREAMYOUTUBE_SHORTSYOUTUBE_IN_FEEDDISCOVERDISPLAY

Example:["YOUTUBE_IN_STREAM"]

adGroups[].googleAudienceIdstring

Google audience resource ID

Example:customers/123/audiences/789

adGroups[].audienceobject

Ad group audience targeting

adGroups[].audience.geoLocationsobject[]

Geo-location targeting

adGroups[].audience.geoLocations[].keystring

Geo target constant resource name

Example:geoTargetConstants/2840

adGroups[].audience.geoLocations[].idstring

Location identifier (place_id)

Example:ChIJOwg_06VPwokRYv534QaPC8g

adGroups[].audience.geoLocations[].namestring

Location display name

Example:New York

adGroups[].audience.geoLocations[].countryNamestring

Country name

Example:United States

adGroups[].audience.geoLocations[].typestring

Location type (city, region, country, address, etc.)

Example:city

adGroups[].audience.geoLocations[].radiusnumber

Radius for proximity targeting

Example:25

adGroups[].audience.geoLocations[].radiusUnitstring

Radius unit

Available optionskmmi

Example:mi

adGroups[].audience.geoLocations[].selectionTypestring

Include or exclude this location

Available optionsincludeexclude

Example:include

adGroups[].audience.geoLocations[].resourceNamestring

Google Ads resource name

Example:customers/123/geoTargetConstants/2840

adGroups[].audience.geoLocations[].placeIdstring

Google place ID

Example:ChIJOwg_06VPwokRYv534QaPC8g

adGroups[].audience.geoLocations[].formattedAddressstring

Full formatted address string

Example:New York, NY, USA

adGroups[].audience.geoLocations[].geometryobject

Geometry data from Google Geocoding API

adGroups[].audience.geoLocations[].addressComponentsobject[]

Address components from Google Geocoding API

adGroups[].audience.localesobject[]

Language/locale targeting

campaignGoalobject

Campaign goal config

adScheduleobject[]

Ad schedule rules

publishingStatusstring

Publishing status

Available optionsDRAFTSCHEDULEDPUBLISHEDPUBLISHINGFAILEDIN_REVIEWPAUSEDARCHIVEDWITH_ISSUESREJECTED

Example:PUBLISHED

googleAdAccountIdstring

Google Ad account identifier

Example:123-456-7890

unpublishedChangesboolean

Whether the campaign has unpublished changes

Example:false

maximumCpcnumber

Maximum CPC bid in micros

Example:2000000

googleCampaignIdstring

Google Ads campaign resource ID

Example:customers/123/campaigns/456

sourcestring

Traffic source

Example:WEBSITE

advancedOptionsobject

Advanced options

customValueMappingsobject

User-provided overrides for custom_values merge tags used in ad copy

Response

application/json

The saved campaign document, same shape as GET /ads/{adId}

idstringrequired

Campaign identifier

Example:6a846b1eb112242a53b21cb0

namestringrequired

Campaign name

Example:Spring promotion

locationIdstringrequired

Location identifier

Example:fRMewNQIxSyZ5R4nQyit

googleAdAccountIdstringrequired

Google Ads customer id the campaign belongs to

Example:6776452901

advertisingChannelTypestringrequired

Advertising channel

Available optionsSEARCHDEMAND_GEN

Example:DEMAND_GEN

publishingStatusstringrequired

Publishing status

Available optionsDRAFTSCHEDULEDPUBLISHEDPUBLISHINGFAILEDIN_REVIEWPAUSEDARCHIVEDWITH_ISSUESREJECTED

Example:DRAFT

sourcestringrequired

Where the campaign was created from

Example:AD_MANAGER

budgetobjectrequired

Budget configuration

networkSettingsobjectrequired

Network placement settings

biddingStrategyobjectrequired

Bidding configuration

campaignGoalobjectrequired

Campaign goal

assetsobjectrequired

Attached assets by kind

audienceobjectrequired

Campaign level targeting

audience.localesobject[]required

Language targeting

audience.geoLocationsobject[]required

Geographic targeting

audience.geoLocations[].keystring

Geo target constant resource name

Example:geoTargetConstants/2840

audience.geoLocations[].idstring

Location identifier (place_id)

Example:ChIJOwg_06VPwokRYv534QaPC8g

audience.geoLocations[].namestring

Location display name

Example:New York

audience.geoLocations[].countryNamestring

Country name

Example:United States

audience.geoLocations[].typestring

Location type (city, region, country, address, etc.)

Example:city

audience.geoLocations[].radiusnumber

Radius for proximity targeting

Example:25

audience.geoLocations[].radiusUnitstring

Radius unit

Available optionskmmi

Example:mi

audience.geoLocations[].selectionTypestring

Include or exclude this location

Available optionsincludeexclude

Example:include

audience.geoLocations[].resourceNamestring

Google Ads resource name

Example:customers/123/geoTargetConstants/2840

audience.geoLocations[].placeIdstring

Google place ID

Example:ChIJOwg_06VPwokRYv534QaPC8g

audience.geoLocations[].formattedAddressstring

Full formatted address string

Example:New York, NY, USA

audience.geoLocations[].geometryobject

Geometry data from Google Geocoding API

audience.geoLocations[].addressComponentsobject[]

Address components from Google Geocoding API

audience.genderobject[]

Gender targeting

audience.ageRangeobject[]

Age range targeting

audience.segmentsstring[]

Audience segment resource names

Example:["customers/6776452901/userLists/9215680180"]

audience.targetInterestsobject

Affinity and in-market interests

adScheduleobject[]required

Ad scheduling windows, empty when the campaign runs continuously

adGroupsobject[]required

Ad groups with their ads

adGroups[].idstringrequired

Ad group identifier

Example:6a846b2db112242a53b21d01

adGroups[].namestringrequired

Ad group name

Example:Ad Group 1

adGroups[].adCampaignIdstringrequired

Parent campaign id

Example:6a846b1eb112242a53b21cb0

adGroups[].googleAdGroupIdstringrequired

Google Ads ad group id, empty until published

Example:

adGroups[].publishingStatusstringrequired

Publishing status

Available optionsDRAFTSCHEDULEDPUBLISHEDPUBLISHINGFAILEDIN_REVIEWPAUSEDARCHIVEDWITH_ISSUESREJECTED

Example:DRAFT

adGroups[].adGroupErrorstringrequired

Publish error, empty when none

Example:

adGroups[].keywordsobjectrequired

Keyword targeting, as positive and negative match objects

adGroups[].customChannelsbooleanrequired

Whether channel placements were chosen manually

Example:false

adGroups[].selectedChannelsstring[]required

Channel placements, Demand Gen only

Available optionsGMAILYOUTUBE_IN_STREAMYOUTUBE_SHORTSYOUTUBE_IN_FEEDDISCOVERDISPLAY

Example:["GMAIL","YOUTUBE_IN_STREAM"]

adGroups[].audienceobjectrequired

Ad group level targeting

adGroups[].audience.localesobject[]required

Language targeting

adGroups[].audience.geoLocationsobject[]required

Geographic targeting

adGroups[].audience.geoLocations[].keystring

Geo target constant resource name

Example:geoTargetConstants/2840

adGroups[].audience.geoLocations[].idstring

Location identifier (place_id)

Example:ChIJOwg_06VPwokRYv534QaPC8g

adGroups[].audience.geoLocations[].namestring

Location display name

Example:New York

adGroups[].audience.geoLocations[].countryNamestring

Country name

Example:United States

adGroups[].audience.geoLocations[].typestring

Location type (city, region, country, address, etc.)

Example:city

adGroups[].audience.geoLocations[].radiusnumber

Radius for proximity targeting

Example:25

adGroups[].audience.geoLocations[].radiusUnitstring

Radius unit

Available optionskmmi

Example:mi

adGroups[].audience.geoLocations[].selectionTypestring

Include or exclude this location

Available optionsincludeexclude

Example:include

adGroups[].audience.geoLocations[].resourceNamestring

Google Ads resource name

Example:customers/123/geoTargetConstants/2840

adGroups[].audience.geoLocations[].placeIdstring

Google place ID

Example:ChIJOwg_06VPwokRYv534QaPC8g

adGroups[].audience.geoLocations[].formattedAddressstring

Full formatted address string

Example:New York, NY, USA

adGroups[].audience.geoLocations[].geometryobject

Geometry data from Google Geocoding API

adGroups[].audience.geoLocations[].addressComponentsobject[]

Address components from Google Geocoding API

adGroups[].audience.genderobject[]

Gender targeting

adGroups[].audience.ageRangeobject[]

Age range targeting

adGroups[].audience.segmentsstring[]

Audience segment resource names

Example:["customers/6776452901/userLists/9215680180"]

adGroups[].audience.targetInterestsobject

Affinity and in-market interests

adGroups[].googleAudienceIdstringrequired

Linked Google audience id, empty when none

Example:

adGroups[].adContentobject[]required

Ads in this group

adGroups[].adContent[].idstring

Ad identifier

Example:ad_abc123

adGroups[].adContent[].namestring

Ad name

Example:Summer Sale Ad

adGroups[].adContent[].mediaTypestring

Media type

Available optionsIMAGEVIDEOCAROUSEL

Example:IMAGE

adGroups[].adContent[].headlinesstring[]

Ad headlines

Example:["Buy Now","Best Deals"]

adGroups[].adContent[].longHeadlinesstring[]

Long headlines

Example:["Discover Great Deals Today"]

adGroups[].adContent[].descriptionsstring[]

Ad descriptions

Example:["Great products"]

adGroups[].adContent[].finalUrlstring

Final URL

Example:https://example.com

adGroups[].adContent[].path1string

Display path 1

Example:products

adGroups[].adContent[].path2string

Display path 2

Example:deals

adGroups[].adContent[].isDeletedboolean

Whether the ad is soft-deleted

Example:false

adGroups[].adContent[].adErrorstring

Ad-level error message from Google

Example:Landing page URL is invalid

adGroups[].adContent[].publishingStatusstring

Ad publishing status

Available optionsDRAFTSCHEDULEDPUBLISHEDPUBLISHINGFAILEDIN_REVIEWPAUSEDARCHIVEDWITH_ISSUESREJECTED

Example:PUBLISHED

adGroups[].adContent[].adIdstring

Internal ad identifier

Example:ad_internal_abc

adGroups[].adContent[].adCampaignIdstring

Ad campaign identifier

Example:camp_abc123

adGroups[].adContent[].adGroupIdstring

Ad group identifier

Example:ag_abc123

adGroups[].adContent[].googleAdIdstring

Google Ads ad resource ID

Example:customers/123/ads/456

adGroups[].adContent[].mediaobject[]

Ad media items

adGroups[].adContent[].callToActionLabelstring

Call to action label

Available optionsAUTOMATEDLEARN_MOREGET_QUOTEAPPLY_NOWSIGN_UPCONTACT_USSUBSCRIBEDOWNLOADBOOK_NOWSHOP_NOWBUY_NOWDONATE_NOW

Example:LEARN_MORE

adGroups[].adContent[].businessNamestring

Business name

Example:Acme Corp

adGroups[].adContent[].youtubeVideoLinksobject[]

YouTube video links

adGroups[].adContent[].carouselCardsobject[]

Carousel cards

adGroups[].adContent[].placementsstring[]

Channel placements

Available optionsGMAILYOUTUBE_IN_STREAMYOUTUBE_SHORTSYOUTUBE_IN_FEEDDISCOVERDISPLAY

Example:["YOUTUBE_IN_STREAM"]

adGroups[].adContent[].customChannelsboolean

Custom channels flag

Example:false

adGroups[].createdAtstringrequired

Created at

Example:2026-08-18T14:24:45.722Z

adGroups[].updatedAtstringrequired

Updated at

Example:2026-08-18T14:36:29.400Z

unpublishedChangesbooleanrequired

Whether the campaign has edits not yet published

Example:false

isEuPoliticalAdsbooleanrequired

Whether the campaign is declared as EU political advertising

Example:false

metaobject

Ancillary campaign metadata

createdBystringrequired

User who created the campaign

Example:hzN33mfYO5c1LHqsExRC

updatedBystringrequired

User who last updated the campaign

Example:hzN33mfYO5c1LHqsExRC

createdAtstringrequired

Created at

Example:2026-08-18T14:24:30.868Z

updatedAtstringrequired

Updated at

Example:2026-08-18T14:36:29.195Z

Upsert Google campaign

Authorizations

Request​

Headers

Body

Response

Request