Google API Discovery Drift Monitor

Monitor Google public Discovery API metadata for API version, preferred-version, revision, schema, method, and OAuth-scope drift.

This Actor is for platform, SaaS integration, API client, governance, and developer-tool teams that depend on Google APIs. It is not affiliated with Google, Google Cloud, or Alphabet, and it does not use Google account credentials.

What it checks

• The public Discovery API directory at https://www.googleapis.com/discovery/v1/apis.
• Selected public Discovery documents via each API version's discoveryRestUrl.
• API name, version, ID, title, documentation link, preferred flag, revision, service path, root URL, base URL, protocol, method count, schema count, resource count, OAuth-scope count, and semantic hashes.
• Alert conditions for missing watched APIs, non-preferred versions, unexpected versions, new versions, preferred-flag drift, revision drift, and Discovery-surface hash drift.

Repeat-use loop

1. Run the Actor once for a watched set such as Drive, Gmail, Calendar, and Sheets.
2. Save the output snapshot or previous dataset rows.
3. Run it on a schedule and pass the previous run back as a baseline.
4. Review only alert, changed, new, or unexpected rows unless you intentionally include unchanged rows.

Input highlights

• apiNamePatterns: exact names or wildcard-style patterns for APIs to monitor.
• criticalApiNames: API names that should become high priority when missing or changed.
• fetchDiscoveryDocuments: fetch public Discovery documents and compute method/schema/scope fingerprints.
• maxDiscoveryDocuments: cap the number of Discovery documents fetched in one run.
• baselineDataset, baselineDatasetId, or baselineRows: previous-run data for drift comparison.
• expectedApiVersions: optional mapping from API name to expected version list.
• maxRows, maxDirectoryBytes, and maxDiscoveryBytes: cost and payload controls for large API surfaces.

Output

Each dataset row is one selected Google API version or one missing watched API row. OUTPUT contains source metadata, alert counts, priority counts, and a compact snapshot suitable for chaining into a later baseline.

Important fields include alert, priority, alertReasons, changedSincePrevious, newSincePrevious, preferred, revision, methodCount, schemaCount, resourceCount, oauthScopeCount, directoryHash, discoveryHash, and semanticHash.

Pricing

This Actor uses Apify Pay Per Event (PPE) pricing:

• apify-actor-start: $0.00005 per run start.
• apify-default-dataset-item: $0.002 per dataset row (Monitor row).
• Platform usage is included in the event price; users do not pay a separate platform-usage pass-through.
• A dataset row is one monitored result, source, or drift-check row emitted by the Actor. Run cost scales with the number of rows produced and the limits you choose.

Use Apify's max total charge setting before starting a run if you want a hard spend cap.

Limitations

• Source data is public Google Discovery API metadata, not a contractual Google SLA and not a live test of every endpoint.
• Some Google APIs are absent from the Discovery API or expose only partial public metadata.
• Discovery document changes can be valid routine API evolution; verify operational impact against official Google documentation before making production changes.
• The Actor intentionally does not use Google account credentials and should not be given private credentials or confidential customer data.

Responsible use

Use this Actor for monitoring public API metadata and internal change review. Do not represent its output as an official Google certification, compliance opinion, or legal advice.