{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/devtune/json-schema/devtune-google-eligibility-data-schema.json",
  "title": "GoogleEligibilityData",
  "x-generated": "2026-11-16",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/devtune-openapi.json#/components/schemas/GoogleEligibilityData",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "window": {
      "type": "object",
      "additionalProperties": false,
      "description": "The reporting window, in UTC days, ending today.",
      "properties": {
        "days": {
          "type": "integer",
          "enum": [
            7,
            30,
            90
          ]
        },
        "dateFrom": {
          "type": "string",
          "format": "date",
          "description": "First day of the window."
        },
        "dateTo": {
          "type": "string",
          "format": "date",
          "description": "Last day of the window, included."
        }
      },
      "required": [
        "days",
        "dateFrom",
        "dateTo"
      ]
    },
    "totals": {
      "type": "object",
      "additionalProperties": false,
      "description": "Counts of pages, sitemaps and properties, not capped by evidenceLimit. A page counts when its latest successful URL Inspection ran inside the window and no more than 14 days ago, on a Search Console property that is connected and active for the project.",
      "properties": {
        "inspectedPages": {
          "type": "integer",
          "minimum": 0,
          "description": "Pages counted, whatever their verdict."
        },
        "indexedPages": {
          "type": "integer",
          "minimum": 0,
          "description": "Pages whose verdict is indexed."
        },
        "inspectionPropertiesMeasured": {
          "type": "integer",
          "minimum": 0,
          "description": "Connected Search Console properties with at least one counted page. When 0, the inspection counts are unmeasured."
        },
        "nonIndexedPages": {
          "type": "integer",
          "minimum": 0,
          "description": "Pages whose verdict is anything other than indexed or error."
        },
        "inspectionErrors": {
          "type": "integer",
          "minimum": 0,
          "description": "Pages whose latest inspection failed (verdict error). They are counted because an earlier inspection in the window succeeded."
        },
        "pendingConfirmationPages": {
          "type": "integer",
          "minimum": 0,
          "description": "Pages with a pendingVerdict: a new verdict waiting for a second inspection to confirm it."
        },
        "confirmedTransitionPages": {
          "type": "integer",
          "minimum": 0,
          "description": "Pages whose confirmed verdict changed inside the window. The same pages as transitions, uncapped."
        },
        "pagesWithAssociatedSitemaps": {
          "type": "integer",
          "minimum": 0,
          "description": "Pages Google lists in at least one sitemap."
        },
        "sitemapPropertiesMeasured": {
          "type": "integer",
          "minimum": 0,
          "description": "Connected Search Console properties whose sitemap list DevTune read in the last 7 days. When 0, the sitemap counts are unmeasured."
        },
        "sitemapSubmissions": {
          "type": "integer",
          "minimum": 0,
          "description": "Sitemaps read inside the window from the properties in sitemapPropertiesMeasured."
        },
        "sitemapSubmissionsWithErrors": {
          "type": "integer",
          "minimum": 0,
          "description": "Of sitemapSubmissions, those Search Console reports at least one error for."
        },
        "sitemapSubmissionsWithWarnings": {
          "type": "integer",
          "minimum": 0,
          "description": "Of sitemapSubmissions, those Search Console reports at least one warning for."
        }
      },
      "required": [
        "inspectedPages",
        "indexedPages",
        "inspectionPropertiesMeasured",
        "nonIndexedPages",
        "inspectionErrors",
        "pendingConfirmationPages",
        "confirmedTransitionPages",
        "pagesWithAssociatedSitemaps",
        "sitemapPropertiesMeasured",
        "sitemapSubmissions",
        "sitemapSubmissionsWithErrors",
        "sitemapSubmissionsWithWarnings"
      ]
    },
    "verdicts": {
      "type": "array",
      "minItems": 9,
      "maxItems": 9,
      "description": "One row for every verdict, in a fixed order, counting the same pages as totals. A verdict no page has reports 0.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "verdict": {
            "type": "string",
            "enum": [
              "indexed",
              "crawled_not_indexed",
              "discovered_not_crawled",
              "duplicate_canonical",
              "blocked_by_robots",
              "blocked_by_noindex",
              "fetch_error",
              "excluded",
              "error"
            ],
            "description": "The latest inspection's outcome: indexed, or the reason Google has not indexed the page. error means the latest inspection request failed."
          },
          "totalCount": {
            "type": "integer",
            "minimum": 0,
            "description": "Pages with this verdict."
          }
        },
        "required": [
          "verdict",
          "totalCount"
        ]
      }
    },
    "pages": {
      "type": "array",
      "maxItems": 25,
      "description": "Up to evidenceLimit of the counted pages, the ones needing attention first: not indexed, then failed inspections, then pending changes, then the most recently inspected.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "domainCanonical": {
            "type": "string",
            "maxLength": 512,
            "description": "The tracked domain whose Search Console property covers the page."
          },
          "pagePath": {
            "type": "string",
            "maxLength": 2048,
            "description": "Path of the page on that domain. Starts with / and has no query or fragment."
          },
          "verdict": {
            "type": "string",
            "enum": [
              "indexed",
              "crawled_not_indexed",
              "discovered_not_crawled",
              "duplicate_canonical",
              "blocked_by_robots",
              "blocked_by_noindex",
              "fetch_error",
              "excluded",
              "error"
            ],
            "description": "The latest inspection's outcome: indexed, or the reason Google has not indexed the page. error means the latest inspection request failed."
          },
          "confirmedVerdict": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "indexed",
              "crawled_not_indexed",
              "discovered_not_crawled",
              "duplicate_canonical",
              "blocked_by_robots",
              "blocked_by_noindex",
              "fetch_error",
              "excluded",
              null
            ],
            "description": "The verdict DevTune treats as current. The first successful inspection sets it; after that, a different verdict must appear in two inspections in a row to replace it. Null when no verdict has been confirmed."
          },
          "pendingVerdict": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "indexed",
              "crawled_not_indexed",
              "discovered_not_crawled",
              "duplicate_canonical",
              "blocked_by_robots",
              "blocked_by_noindex",
              "fetch_error",
              "excluded",
              null
            ],
            "description": "A verdict that differs from confirmedVerdict, seen in the latest successful inspection and waiting for the next one to confirm it. Null when nothing is waiting."
          },
          "coverageState": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 512,
            "description": "Google's coverage state for the page, worded as Search Console shows it, such as Submitted and indexed. Null when the latest inspection failed or reported none."
          },
          "googleCanonical": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048,
            "description": "The canonical URL Google selected for the page. Null when the inspection did not report one."
          },
          "userCanonical": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 2048,
            "description": "The canonical URL the page declares. Null when the inspection did not report one."
          },
          "robotsTxtState": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256,
            "description": "Google's robots.txt result for the page, such as ALLOWED or DISALLOWED. Null when the inspection did not report one."
          },
          "indexingState": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256,
            "description": "Google's indexing state, such as INDEXING_ALLOWED or BLOCKED_BY_META_TAG. Null when the inspection did not report one."
          },
          "pageFetchState": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256,
            "description": "Google's fetch result, such as SUCCESSFUL, SOFT_404 or SERVER_ERROR. Null when the inspection did not report one."
          },
          "crawledAs": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 256,
            "description": "Which Googlebot crawled the page, such as MOBILE or DESKTOP. Null when the inspection did not report it."
          },
          "associatedSitemapCount": {
            "type": "integer",
            "minimum": 0,
            "description": "Sitemaps URL Inspection lists for the page, counting up to 20. associatedSitemaps shows the first 10."
          },
          "associatedSitemaps": {
            "type": "array",
            "maxItems": 10,
            "description": "The first 10 sitemap URLs Google lists for the page.",
            "items": {
              "type": "string",
              "maxLength": 2048
            }
          },
          "referringUrlCount": {
            "type": "integer",
            "minimum": 0,
            "description": "URLs Google reports as linking to the page, counting up to 50. referringUrls shows the first 10."
          },
          "referringUrls": {
            "type": "array",
            "maxItems": 10,
            "description": "The first 10 URLs Google reports as linking to the page.",
            "items": {
              "type": "string",
              "maxLength": 2048
            }
          },
          "richResults": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true,
            "description": "Google's rich results result for the page, as Search Console returns it: an overall verdict and the items it detected. Null when the inspection reported none."
          },
          "dimensions": {
            "$ref": "#/$defs/GoogleEligibilityDimensions"
          },
          "observedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the latest successful inspection ran."
          },
          "lastCrawlTime": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "When Google last crawled the page, as Search Console reports it. Null when it reports no crawl."
          }
        },
        "required": [
          "domainCanonical",
          "pagePath",
          "verdict",
          "confirmedVerdict",
          "pendingVerdict",
          "coverageState",
          "googleCanonical",
          "userCanonical",
          "robotsTxtState",
          "indexingState",
          "pageFetchState",
          "crawledAs",
          "associatedSitemapCount",
          "associatedSitemaps",
          "referringUrlCount",
          "referringUrls",
          "richResults",
          "dimensions",
          "observedAt",
          "lastCrawlTime"
        ]
      }
    },
    "transitions": {
      "type": "array",
      "maxItems": 25,
      "description": "Up to evidenceLimit pages whose confirmed verdict changed inside the window, newest change first. A page whose latest inspection failed, or disagrees with the new verdict, is left out.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "domainCanonical": {
            "type": "string",
            "maxLength": 512,
            "description": "The tracked domain whose Search Console property covers the page."
          },
          "pagePath": {
            "type": "string",
            "maxLength": 2048,
            "description": "Path of the page on that domain. Starts with / and has no query or fragment."
          },
          "previousConfirmedVerdict": {
            "type": "string",
            "enum": [
              "indexed",
              "crawled_not_indexed",
              "discovered_not_crawled",
              "duplicate_canonical",
              "blocked_by_robots",
              "blocked_by_noindex",
              "fetch_error",
              "excluded"
            ],
            "description": "The confirmed verdict before the change."
          },
          "confirmedVerdict": {
            "type": "string",
            "enum": [
              "indexed",
              "crawled_not_indexed",
              "discovered_not_crawled",
              "duplicate_canonical",
              "blocked_by_robots",
              "blocked_by_noindex",
              "fetch_error",
              "excluded"
            ],
            "description": "The confirmed verdict after the change, seen in two inspections in a row."
          },
          "coverageState": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 512,
            "description": "Google's coverage state for the page, worded as Search Console shows it, such as Submitted and indexed. Null when the latest inspection failed or reported none."
          },
          "dimensions": {
            "$ref": "#/$defs/GoogleEligibilityDimensions"
          },
          "observedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the latest successful inspection ran."
          },
          "transitionedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the inspection that confirmed the change ran."
          }
        },
        "required": [
          "domainCanonical",
          "pagePath",
          "previousConfirmedVerdict",
          "confirmedVerdict",
          "coverageState",
          "dimensions",
          "observedAt",
          "transitionedAt"
        ]
      }
    },
    "sitemaps": {
      "type": "array",
      "maxItems": 25,
      "description": "Up to evidenceLimit of the sitemaps in sitemapSubmissions, the ones needing attention first: errors, then warnings, then pending, then the most recently read.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "domainCanonical": {
            "description": "The tracked domain whose Search Console property lists the sitemap.",
            "type": "string",
            "maxLength": 512
          },
          "sitemapUrl": {
            "type": "string",
            "maxLength": 2048,
            "description": "The sitemap URL: one submitted to Search Console, or one listed inside a submitted sitemap index."
          },
          "sitemapType": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 64,
            "description": "The sitemap type Search Console reports, such as sitemap or rssFeed. Null when it reports none."
          },
          "isPending": {
            "type": "boolean",
            "description": "True while Search Console has not finished processing the sitemap."
          },
          "isSitemapsIndex": {
            "type": "boolean",
            "description": "True when the file is a sitemap index that lists other sitemaps."
          },
          "lastSubmitted": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "When the sitemap was last submitted. Null when Search Console reports no submission date."
          },
          "lastDownloaded": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "When Google last downloaded the sitemap. Null when Google has never downloaded it."
          },
          "errorCount": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "description": "Errors Search Console reports for the sitemap. Null when it reports no count."
          },
          "warningCount": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "description": "Warnings Search Console reports for the sitemap. Null when it reports no count."
          },
          "submittedUrlCount": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "description": "Web page URLs the sitemap submits; other content types, such as images and video, are not counted. Null when Search Console reports no web page count."
          },
          "fetchedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When DevTune read this sitemap from Search Console."
          }
        },
        "required": [
          "domainCanonical",
          "sitemapUrl",
          "sitemapType",
          "isPending",
          "isSitemapsIndex",
          "lastSubmitted",
          "lastDownloaded",
          "errorCount",
          "warningCount",
          "submittedUrlCount",
          "fetchedAt"
        ]
      }
    }
  },
  "required": [
    "window",
    "totals",
    "verdicts",
    "pages",
    "transitions",
    "sitemaps"
  ],
  "$defs": {
    "GoogleEligibilityDimensions": {
      "type": "object",
      "additionalProperties": false,
      "description": "Each indexing check, read from the latest inspection. pass and fail are measured; unmeasured means the inspection did not report enough to decide.",
      "properties": {
        "canonical": {
          "type": "string",
          "enum": [
            "pass",
            "fail",
            "unmeasured"
          ],
          "description": "pass when the canonical URL Google selected matches the one the page declares, fail when they differ, unmeasured when either is missing."
        },
        "crawlable": {
          "type": "string",
          "enum": [
            "pass",
            "fail",
            "unmeasured"
          ],
          "description": "fail when robots.txt blocks Google or Google could not fetch the page. pass when robots.txt allows the page, the fetch succeeded and indexing was allowed or blocked only by noindex. unmeasured otherwise, such as when the inspection did not report all three."
        },
        "indexed": {
          "type": "string",
          "enum": [
            "pass",
            "fail",
            "unmeasured"
          ],
          "description": "pass when Google indexed the page, fail when the verdict is any other outcome, unmeasured when the inspection failed or reported no detail."
        },
        "structuredData": {
          "type": "string",
          "enum": [
            "pass",
            "fail",
            "unmeasured"
          ],
          "description": "pass when Google's rich results check passed. fail when it failed, passed only in part, or found no rich results. unmeasured when the inspection reported no detail."
        }
      },
      "required": [
        "canonical",
        "crawlable",
        "indexed",
        "structuredData"
      ]
    }
  }
}