GeoEligibility
Eligibility restrictions for a geographic location, scoped to the supply source specified in the request.
Declaration
object GeoEligibilityProperties
| Name | Type | Description |
|---|---|---|
blockedGroups | [GeoBlockedGroup] | Array of GeoBlockedGroup objects. Each entry specifies the supply source and the reason the geo is blocked. Always non-empty when present. |
Discussion
The SearchEntity responses embed GeoEligibility, which summarizes the serving eligibility for a geographic location relative to the supply source specified in the request. When present, blockedGroups is always non-empty. The API omits GeoEligibility entirely from the response when no restrictions apply. Each GeoBlockedGroup entry in blockedGroups identifies the supply source and the reason the geo is blocked.
To pre-validate geo targeting choices before applying them to an ad group and avoid campaign configuration errors, use GeoEligibility data.
Example
{
"blockedGroups": [
{
"supplySource": [
"MAPS"
],
"reasons": [
"COUNTRY_NOT_SUPPORTED"
]
}
]
}