AssetEligibility
Eligibility status and constraint details for an asset.
Declaration
object AssetEligibilityProperties
| Name | Type | Description |
|---|---|---|
status | AssetEligibilityStatus | Overall eligibility status. Read-only. |
blockedGroups | [AssetConstraintGroup] | Constraint groups where the asset is blocked from serving. See AssetConstraintGroup. Read-only. |
allowedGroups | [AssetConstraintGroup] | Constraint groups where the asset is explicitly allowed to serve. See AssetConstraintGroup. Read-only. |
Discussion
The AssetEligibility object captures the policy evaluation result for an asset. The Asset responses always include it (unless excluded via the fields parameter), and it describes whether and where the asset can be used for ad serving.
Check AssetEligibility before including an asset in a creative. You can’t use assets with INELIGIBLE or PENDING status in any ad unit. Assets with LIMITED status can serve in some placements or markets. See AssetEligibilityStatus for the full list of status values.
Example
{
"status": "LIMITED",
"blockedGroups": [
{
"supplyPlacement": ["SEARCH_TAB"],
"countryOrRegion": ["CN"]
}
],
"allowedGroups": [
{
"supplyPlacement": ["SEARCH_TAB", "TODAY_TAB", "SEARCH_RESULTS"],
"countryOrRegion": ["US", "GB"]
}
]
}