Upsert audience

PUT 
/ad-publishing/google/audiences

Create or update a Google Ads combined audience

Request

Version stringrequired

API Version

Available options2021-04-15

application/json

application/json

Body

Bodyrequired

locationIdstringrequired

Location identifier

resourceNamestring

Audience resource name

namestringrequired

Audience name

dimensionsobject

Audience dimensions

exclusionDimensionobject

Exclusion dimensions

Example (auto)

{
  "locationId": "loc_abc123",
  "resourceName": "customers/123/audiences/456",
  "name": "My Audience",
  "dimensions": {
    "isAgeUnknown": false,
    "ageRanges": [
      {
        "minAge": 25,
        "maxAge": 34
      }
    ],
    "genders": [
      "MALE",
      "FEMALE"
    ]
  },
  "exclusionDimension": {
    "genders": [
      "UNDETERMINED"
    ]
  }
}

application/json

Google Ads mutate results for the created or updated audience — an array, not the audience itself

application/json

Schema

Schema

• Array [
resourceNamestringrequired

Resource name of the affected record, as returned by the Google Ads mutate call

• ]

Example (auto)

[
  {
    "resourceName": "customers/6776452901/conversionActions/7086809727"
  }
]