Google AdsVersion: v3

Publish ad

POST/ad-publishing/google/ads/{adId}/publish

Publish a Google ad and push it live

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

Path Parameters

adIdstringrequired

Ad identifier

Example:507f1f77bcf86cd799439011

Body

application/json

locationIdstringrequired

Location identifier

Example:HChooFuiyPpVYzeJ4HMe

Response

application/json

The campaign moved to PUBLISHING. Returns the raw document, so the id is _id and adGroups are not populated.

_idstringrequired

Campaign identifier, as _id rather than id

Example:6a8438b2b112242a53b1ea6a

__vnumberrequired

Mongoose internal version key

Example:6

namestringrequired

Campaign name

Example:Spring promotion

locationIdstringrequired

Location identifier

Example:fRMewNQIxSyZ5R4nQyit

googleAdAccountIdstringrequired

Google Ads customer id

Example:6776452901

advertisingChannelTypestringrequired

Advertising channel

Available optionsSEARCHDEMAND_GEN

Example:SEARCH

publishingStatusstringrequired

Status after the publish request, normally PUBLISHING

Available optionsDRAFTSCHEDULEDPUBLISHEDPUBLISHINGFAILEDIN_REVIEWPAUSEDARCHIVEDWITH_ISSUESREJECTED

Example:PUBLISHING

sourcestringrequired

Where the campaign was created from

Example:AD_MANAGER

budgetobjectrequired

Budget configuration

networkSettingsobjectrequired

Network placement settings

biddingStrategyobjectrequired

Bidding configuration. value is omitted for strategies that do not take a target.

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

metaobject

Ancillary campaign metadata

googleErrorstringnullable

Publish error from Google, null when the request was accepted

Example:null

isEuPoliticalAdsbooleanrequired

Whether the campaign is declared as EU political advertising

Example:false

createdBystringrequired

User who created the campaign

Example:uPy3hdVIuuNlbWOpBYGw

updatedBystringrequired

User who last updated the campaign

Example:hzN33mfYO5c1LHqsExRC

createdAtstringrequired

Created at

Example:2026-08-18T10:49:22.412Z

updatedAtstringrequired

Updated at

Example:2026-08-19T08:10:33.333Z