Get audience by ID

GET 
/ad-publishing/google/audiences/:audienceId

Retrieve a specific Google Ads combined audience by ID

Request

Version stringrequired

API Version

Available optionsv3

audienceId stringrequired

Audience identifier

locationId stringrequired

Location identifier

application/json

The combined audience

application/json

Schema

Schema

resourceNamestringrequired

Google Ads resource name

idstringrequired

Audience id

statusstringrequired

Audience status

namestringrequired

Audience name

scopestringrequired

Scope the audience is defined at

dimensionsobjectrequired

Inclusion targeting

exclusionDimensionobjectrequired

Exclusion targeting

Example (auto)

{
  "resourceName": "customers/6776452901/audiences/330214962",
  "id": "330214962",
  "status": "ENABLED",
  "name": "Returning customers",
  "scope": "CUSTOMER",
  "dimensions": {
    "ageRanges": [
      {
        "minAge": 18,
        "maxAge": 64
      }
    ],
    "genders": [
      "MALE"
    ],
    "incomeRanges": [
      "INCOME_RANGE_0_50"
    ],
    "parentalStatuses": [
      "PARENT"
    ],
    "audienceSegments": {
      "customAudiences": [
        "customers/6776452901/customAudiences/901256299"
      ],
      "userLists": [
        "customers/6776452901/userLists/9144367872"
      ],
      "userInterests": [
        "customers/6776452901/userInterests/80276"
      ]
    },
    "isAgeUnknown": true,
    "isHouseHoldIncomeUnknown": true
  },
  "exclusionDimension": {
    "userLists": [
      "customers/6776452901/userLists/8999046675"
    ]
  }
}