Eligibility API: Sample Flows

This article presents possible use cases and corresponding sample flows that you can support. It provides a useful starting point as you plan your implementation.

Check a site's eligibility before you start advertising

Before your app starts advertising for a site, it can confirm that the site meets the requirements and guide the site owner through anything that's missing.

To check eligibility before you start advertising:

  1. Call Get Eligibility Info in the context of the site.
  2. From eligibilityInfo.criterias, collect the entries whose eligible is false, and show the site owner what to do for each one:
    • SITE_PUBLISHED: Publish the site.
    • HAS_PREMIUM: Upgrade the site to a Premium plan.
    • DOMAIN_CONNECTED: Connect a custom domain to the site.
  3. After the site owner makes the changes, call Get Eligibility Info again and confirm that eligibilityInfo.eligible is true.
  4. Start advertising for the site. For example, create a campaign with the Google Ads Campaign API.

Find out why a site's ads stopped serving

When a site that already advertises stops meeting a requirement, its ads stop serving. Your app can explain the cause to the site owner.

To find out why a site's ads stopped serving:

  1. Call Get Eligibility Info in the context of the site.
  2. From eligibilityInfo.criterias, find the entries whose eligible is false. These are the requirements the site no longer meets.
  3. Tell the site owner which requirements to fix. For example, republish the site or renew its Premium plan.
  4. After the site owner makes the changes, call Get Eligibility Info again and confirm that eligibilityInfo.eligible is true.

Last updated: 15 November 2026

Did this help?