Contents

Eligibility

Eligibility status and constraint details for a Business domain entity.

Declaration

object Eligibility

Properties

NameTypeDescription
statusEligibilityStatus

Overall eligibility status (ELIGIBLE, INELIGIBLE, LIMITED, PENDING, or UNDEFINED). See EligibilityStatus. Read-only.

blockedGroups[ConstraintGroup]

Constraint groups where the entity is blocked from serving. See ConstraintGroup. Read-only.

allowedGroups[ConstraintGroup]

Constraint groups where the entity is allowed to serve. See ConstraintGroup. Read-only.

modificationTimedate-time

Timestamp of the last eligibility evaluation. Read-only.

Discussion

The Eligibility object captures the serving eligibility state for a Business domain entity, such as a brand or location, across supply sources and geographic markets.

Geo and brand eligibility lookup responses typically include this object, so you can use it to understand which supply placements and markets are accessible before configuring ad group targeting.

Example

{
  "status": "LIMITED",
  "blockedGroups": [
    {
      "supplyPlacement": ["SEARCH_TAB", "TODAY_TAB"],
      "countryOrRegion": ["CN"]
    }
  ],
  "allowedGroups": [
    {
      "supplyPlacement": ["SEARCH_TAB", "SEARCH_RESULTS"],
      "countryOrRegion": ["US", "GB"]
    }
  ],
  "modificationTime": "2025-01-10T08:00:00.000"
}

See Also