Upsert Google campaign

PUT 
/ad-publishing/google/ads

Create or update a full Google Ads campaign structure

Request

Version stringrequired

API Version

Available optionsv3

application/json

application/json

Body

Bodyrequired

idstring

Campaign identifier

namestringrequired

Campaign name

locationIdstringrequired

Location identifier

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
advertisingChannelSubTypestring
Channel sub type
Available optionsDEMAND_GEN
goalTypestring
Goal type
Available optionsWEBSITE_TRAFFICLEAD
budgetobject

Campaign budget

audienceobject

Campaign audience targeting

networkSettingsobject

Network settings

biddingStrategyobject

Bidding strategy config

assetsobject

Campaign assets

isEuPoliticalAdsboolean

EU political ads flag

adGroupsobject[]

Campaign ad groups

campaignGoalobject

Campaign goal config

adScheduleobject[]

Ad schedule rules

publishingStatusstring
Publishing status
Available optionsDRAFTSCHEDULEDPUBLISHEDPUBLISHINGFAILEDIN_REVIEWPAUSEDARCHIVEDWITH_ISSUESREJECTED
googleAdAccountIdstring

Google Ad account identifier

unpublishedChangesboolean

Whether the campaign has unpublished changes

maximumCpcnumber

Maximum CPC bid in micros

googleCampaignIdstring

Google Ads campaign resource ID

sourcestring

Traffic source

advancedOptionsobject

Advanced options

customValueMappingsobject

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

Example (auto)

{
  "id": "camp_abc123",
  "name": "My Campaign",
  "locationId": "loc_abc123",
  "advertisingChannelType": "SEARCH",
  "advertisingChannelSubType": "DEMAND_GEN",
  "goalType": "WEBSITE_TRAFFIC",
  "budget": {
    "budgetType": "DAILY",
    "amount": 5000,
    "scheduleStartDate": "2024-01-01"
  },
  "audience": {
    "geoLocations": [
      {
        "key": "geoTargetConstants/2840",
        "name": "United States"
      }
    ]
  },
  "networkSettings": {
    "targetSearchNetwork": true,
    "targetContentNetwork": false
  },
  "biddingStrategy": {
    "type": "MAXIMIZE_CONVERSIONS",
    "value": 1000000
  },
  "assets": {
    "calls": [],
    "sitelinks": [],
    "images": []
  },
  "isEuPoliticalAds": false,
  "adGroups": [
    {
      "id": "ag_1",
      "name": "Ad Group 1",
      "adContent": []
    }
  ],
  "campaignGoal": {
    "type": "WEBSITE_TRAFFIC",
    "isCustomConversionGoal": false
  },
  "adSchedule": [
    {
      "dayOfWeek": "MONDAY",
      "from": "09:00",
      "to": "17:00"
    }
  ],
  "publishingStatus": "PUBLISHED",
  "googleAdAccountId": "123-456-7890",
  "unpublishedChanges": false,
  "maximumCpc": 2000000,
  "googleCampaignId": "customers/123/campaigns/456",
  "source": "WEBSITE",
  "advancedOptions": {
    "source": "WEBSITE",
    "postId": "post_abc123"
  },
  "customValueMappings": {
    "{{ custom_values.pet_name }}": "Fluffy"
  }
}

application/json

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

application/json

Schema

Schema

idstringrequired

Campaign identifier

namestringrequired

Campaign name

locationIdstringrequired

Location identifier

googleAdAccountIdstringrequired

Google Ads customer id the campaign belongs to

advertisingChannelTypestringrequired
Advertising channel
Available optionsSEARCHDEMAND_GEN
publishingStatusstringrequired
Publishing status
Available optionsDRAFTSCHEDULEDPUBLISHEDPUBLISHINGFAILEDIN_REVIEWPAUSEDARCHIVEDWITH_ISSUESREJECTED
sourcestringrequired

Where the campaign was created from

budgetobjectrequired

Budget configuration

networkSettingsobjectrequired

Network placement settings

biddingStrategyobjectrequired

Bidding configuration

campaignGoalobjectrequired

Campaign goal

assetsobjectrequired

Attached assets by kind

audienceobjectrequired

Campaign level targeting

adScheduleobject[]required

Ad scheduling windows, empty when the campaign runs continuously

adGroupsobject[]required

Ad groups with their ads

unpublishedChangesbooleanrequired

Whether the campaign has edits not yet published

isEuPoliticalAdsbooleanrequired

Whether the campaign is declared as EU political advertising

metaobject

Ancillary campaign metadata

createdBystringrequired

User who created the campaign

updatedBystringrequired

User who last updated the campaign

createdAtstringrequired

Created at

updatedAtstringrequired

Updated at

Example (auto)

{
  "id": "6a846b1eb112242a53b21cb0",
  "name": "Spring promotion",
  "locationId": "fRMewNQIxSyZ5R4nQyit",
  "googleAdAccountId": "6776452901",
  "advertisingChannelType": "DEMAND_GEN",
  "publishingStatus": "DRAFT",
  "source": "AD_MANAGER",
  "budget": {
    "budgetType": "DAILY",
    "amount": 50,
    "scheduleStartDate": "2026-08-18T00:00:00.000Z",
    "scheduleEndDate": "2026-09-18T00:00:00.000Z"
  },
  "networkSettings": {
    "targetSearchNetwork": true,
    "targetContentNetwork": false
  },
  "biddingStrategy": {
    "type": "MAXIMIZE_CONVERSIONS",
    "value": 0
  },
  "campaignGoal": {
    "type": "CONVERSIONS",
    "value": "ADD_TO_CART",
    "isCustomConversionGoal": false
  },
  "assets": {
    "calls": [],
    "sitelinks": [],
    "leadForm": "",
    "images": []
  },
  "audience": {
    "locales": [
      {
        "name": "English",
        "key": "1000",
        "id": "1000",
        "resourceName": "languageConstants/1000"
      }
    ],
    "geoLocations": [
      {
        "key": "geoTargetConstants/2840",
        "id": "ChIJOwg_06VPwokRYv534QaPC8g",
        "name": "New York",
        "countryName": "United States",
        "type": "city",
        "radius": 25,
        "radiusUnit": "mi",
        "selectionType": "include",
        "resourceName": "customers/123/geoTargetConstants/2840",
        "placeId": "ChIJOwg_06VPwokRYv534QaPC8g",
        "formattedAddress": "New York, NY, USA",
        "geometry": {
          "location": {
            "lat": 40.7128,
            "lng": -74.006
          },
          "locationType": "APPROXIMATE"
        },
        "addressComponents": [
          {
            "longName": "New York",
            "shortName": "NY",
            "types": [
              "locality",
              "political"
            ]
          }
        ]
      }
    ],
    "gender": [
      {
        "enum": "MALE",
        "negative": false
      }
    ],
    "ageRange": [
      {
        "enum": "AGE_RANGE_25_34",
        "negative": false
      }
    ],
    "segments": [],
    "targetInterests": {
      "affinity": [],
      "inMarket": []
    }
  },
  "adSchedule": [
    {
      "dayOfWeek": "ALL_DAYS",
      "from": "09_00",
      "to": "17_30",
      "_id": "6a855ca9867e604d24f4b8fa"
    }
  ],
  "adGroups": [
    {
      "id": "6a846b2db112242a53b21d01",
      "name": "Ad Group 1",
      "adCampaignId": "6a846b1eb112242a53b21cb0",
      "googleAdGroupId": "",
      "publishingStatus": "DRAFT",
      "adGroupError": "",
      "keywords": {
        "positives": [],
        "negatives": []
      },
      "customChannels": false,
      "selectedChannels": [
        "GMAIL",
        "YOUTUBE_IN_STREAM"
      ],
      "audience": {
        "locales": [
          {
            "name": "English",
            "key": "1000",
            "id": "1000",
            "resourceName": "languageConstants/1000"
          }
        ],
        "geoLocations": [
          {
            "key": "geoTargetConstants/2840",
            "id": "ChIJOwg_06VPwokRYv534QaPC8g",
            "name": "New York",
            "countryName": "United States",
            "type": "city",
            "radius": 25,
            "radiusUnit": "mi",
            "selectionType": "include",
            "resourceName": "customers/123/geoTargetConstants/2840",
            "placeId": "ChIJOwg_06VPwokRYv534QaPC8g",
            "formattedAddress": "New York, NY, USA",
            "geometry": {
              "location": {
                "lat": 40.7128,
                "lng": -74.006
              },
              "locationType": "APPROXIMATE"
            },
            "addressComponents": [
              {
                "longName": "New York",
                "shortName": "NY",
                "types": [
                  "locality",
                  "political"
                ]
              }
            ]
          }
        ],
        "gender": [
          {
            "enum": "MALE",
            "negative": false
          }
        ],
        "ageRange": [
          {
            "enum": "AGE_RANGE_25_34",
            "negative": false
          }
        ],
        "segments": [],
        "targetInterests": {
          "affinity": [],
          "inMarket": []
        }
      },
      "googleAudienceId": "",
      "adContent": [
        {
          "id": "ad_abc123",
          "name": "Summer Sale Ad",
          "mediaType": "IMAGE",
          "headlines": [
            "Buy Now",
            "Best Deals"
          ],
          "longHeadlines": [
            "Discover Great Deals Today"
          ],
          "descriptions": [
            "Great products"
          ],
          "finalUrl": "https://example.com",
          "path1": "products",
          "path2": "deals",
          "isDeleted": false,
          "adError": "Landing page URL is invalid",
          "publishingStatus": "PUBLISHED",
          "adId": "ad_internal_abc",
          "adCampaignId": "camp_abc123",
          "adGroupId": "ag_abc123",
          "googleAdId": "customers/123/ads/456",
          "media": [
            {
              "type": "IMAGE",
              "src": "https://example.com/ad.jpg"
            }
          ],
          "callToActionLabel": "LEARN_MORE",
          "businessName": "Acme Corp",
          "youtubeVideoLinks": [
            {
              "youtubeVideoId": "dQw4w9WgXcQ"
            }
          ],
          "carouselCards": [
            {
              "headline": "Shop Now",
              "finalUrl": "https://example.com",
              "callToActionLabel": "LEARN_MORE"
            }
          ],
          "placements": [
            "YOUTUBE_IN_STREAM"
          ],
          "customChannels": false
        }
      ],
      "createdAt": "2026-08-18T14:24:45.722Z",
      "updatedAt": "2026-08-18T14:36:29.400Z"
    }
  ],
  "unpublishedChanges": false,
  "isEuPoliticalAds": false,
  "meta": {
    "evaluate": "{\"opportunityScore\":18,\"confidence\":\"High\",\"band\":\"Low\",\"categories\":[],\"fixItems\":[]}"
  },
  "createdBy": "hzN33mfYO5c1LHqsExRC",
  "updatedBy": "hzN33mfYO5c1LHqsExRC",
  "createdAt": "2026-08-18T14:24:30.868Z",
  "updatedAt": "2026-08-18T14:36:29.195Z"
}