Google Search Console

Use the @bijection/connectors/google-search-console entrypoint to declare Google Search Console resources.

Availability

This page describes the pinned source package. Published availability is unestablished for this artifact. Source build and package availability.

Resources and modes

Resource	Mode	Description
Search analytics	`daily`	Daily search analytics settled by first_incomplete_date

Declare a resource in application code, then bind deployment-specific settings and credentials. See typed resources, connections and source inspection.

Search analytics

daily: Daily search analytics settled by first_incomplete_date

The following example matches configuration queries.

import { searchConsole } from "@bijection/connectors/google-search-console";
export const queryDays = searchConsole.searchAnalytics.daily({
  start: "2026-01-01",
  dimensions: ["query", "page"],
});

Inferred record types

Resource without an operational record table

Configuration: queries

Case: google-search-console/searchAnalytics/daily/queries. Connection and resource configuration are declared by this exact case. Credential kind: google-search-console. Keep credential material in the private credential inventory.

Setting	Type	Required	Owner
`siteUrl`	string	Yes	Resource binding

Complete configuration contract

{
  "setup": [],
  "resource": {
    "access": {},
    "defaults": {},
    "connector": "google-search-console",
    "output": {
      "kind": "single",
      "collection": "searchAnalytics"
    },
    "credential_kind": "google-search-console",
    "connection_fields": [],
    "address": {
      "kind": "fixed",
      "url": "https://www.googleapis.com"
    }
  },
  "connection_setup": {
    "type": "object",
    "value": {
      "siteUrl": {
        "fieldType": {
          "type": "string"
        },
        "optional": false
      }
    }
  },
  "execution": null
}

Native admission analysis is available for this exact declaration. Collection: searchAnalytics

Contract	Meaning
Initial	Enumeration of observed records
Changes	Repeated observations of current records
Deletions	Deletion detection unsupported
Resume	No continuation
Gap	Not applicable
Retention	Unspecified

Complete native profile

{
  "movement": {
    "exchanges": {
      "query": {
        "200": {
          "placement": "retained_bytes",
          "interpretation": "json",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "400": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "403": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "429": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        }
      }
    },
    "nativeInputLimitBytes": null,
    "steps": [
      {
        "id": "acquire.1",
        "inputs": [],
        "action": {
          "operation": "acquire",
          "subject": "exchange query",
          "limitBytes": null
        }
      },
      {
        "id": "retain.1",
        "inputs": [
          "acquire.1"
        ],
        "action": {
          "operation": "retain",
          "subject": "acquisition evidence",
          "reason": "recovery",
          "release": "acquisition_custody"
        }
      },
      {
        "id": "interpret.1",
        "inputs": [
          "retain.1"
        ],
        "action": {
          "operation": "interpret",
          "subject": "acquired input",
          "produces": "records"
        }
      },
      {
        "id": "materialize.1",
        "inputs": [
          "interpret.1"
        ],
        "action": {
          "operation": "materialize",
          "subject": "source rows",
          "reason": "serving",
          "release": "replacement"
        }
      },
      {
        "id": "publish.1",
        "inputs": [
          "materialize.1"
        ],
        "action": {
          "operation": "publish",
          "subject": "source rows",
          "visibility": "with_acquisition"
        }
      }
    ]
  },
  "initial": "enumeration",
  "changes": "observations",
  "deletions": "unsupported",
  "resume": "none",
  "retentionMs": null,
  "gap": "not_applicable",
  "limits": {
    "http_response_bytes": "524288"
  },
  "restrictions": [],
  "commands": {}
}

Commands, occurrences and artifacts

{
  "records": {
    "searchAnalytics": {
      "protocol": "record_observation",
      "coverage": "records",
      "consistency": "observations",
      "atomicity": "record",
      "history": "observations",
      "recordRefresh": false,
      "reconciliation": false,
      "notifications": false,
      "snapshotMaxRows": null,
      "profile": {
        "movement": {
          "exchanges": {
            "query": {
              "200": {
                "placement": "retained_bytes",
                "interpretation": "json",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "400": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "403": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "429": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              }
            }
          },
          "nativeInputLimitBytes": null,
          "steps": [
            {
              "id": "acquire.1",
              "inputs": [],
              "action": {
                "operation": "acquire",
                "subject": "exchange query",
                "limitBytes": null
              }
            },
            {
              "id": "retain.1",
              "inputs": [
                "acquire.1"
              ],
              "action": {
                "operation": "retain",
                "subject": "acquisition evidence",
                "reason": "recovery",
                "release": "acquisition_custody"
              }
            },
            {
              "id": "interpret.1",
              "inputs": [
                "retain.1"
              ],
              "action": {
                "operation": "interpret",
                "subject": "acquired input",
                "produces": "records"
              }
            },
            {
              "id": "materialize.1",
              "inputs": [
                "interpret.1"
              ],
              "action": {
                "operation": "materialize",
                "subject": "source rows",
                "reason": "serving",
                "release": "replacement"
              }
            },
            {
              "id": "publish.1",
              "inputs": [
                "materialize.1"
              ],
              "action": {
                "operation": "publish",
                "subject": "source rows",
                "visibility": "with_acquisition"
              }
            }
          ]
        },
        "initial": "enumeration",
        "changes": "observations",
        "deletions": "unsupported",
        "resume": "none",
        "retentionMs": null,
        "gap": "not_applicable",
        "limits": {
          "http_response_bytes": "524288"
        },
        "restrictions": [],
        "commands": {}
      }
    }
  },
  "occurrences": null,
  "artifacts": {
    "raw_archive": false,
    "native_file_transfer_limit_bytes": null,
    "external_versions": false,
    "files": {}
  },
  "commands": {}
}

Recorded checks

Requirement	Scope	Evidence	Result
page-publication-recovery	{“kind”:“collection”,“name”:“searchAnalytics”}	Fixture: ./src/connectors/google-search-console/fixtures/fresh-day-unsettled.json	passed (2026-10-24T21:36:12.323Z)
page-publication-recovery	{“kind”:“collection”,“name”:“searchAnalytics”}	Fixture: ./src/connectors/google-search-console/fixtures/final-day-settled.json	passed (2026-10-24T21:36:12.323Z)
page-publication-recovery	{“kind”:“collection”,“name”:“searchAnalytics”}	Fixture: ./src/connectors/google-search-console/fixtures/empty-day-advances.json	passed (2026-10-24T21:36:12.324Z)
page-publication-recovery	{“kind”:“collection”,“name”:“searchAnalytics”}	Native test: integrations/acquisition/acquisition_windows_preserve_sequences_and_restart_fences_old_work (shared_engine)	Execution result unavailable
backoff-stated-wait	{“kind”:“connection”}	Native test: integrations/acquisition/backoff_a_stated_wait_defers_the_next_dispatch_and_then_resumes (shared_engine)	Execution result unavailable
identity-account	{“kind”:“connection”}	Fixture: ./src/connectors/google-search-console/fixtures/identity.json	passed (2026-10-24T21:36:12.324Z)

Hosted qualification: unestablished for this catalog configuration. Installed connections report their own identity, authority and current status.

Provider guidance

Compiled declaration examples and configuration details are published in the connector reference. Daily search analytics from POST https://www.googleapis.com/webmasters/v3/sites/{siteUrl}/searchAnalytics/query, one Pacific Time day per request, with date first and the declared dimensions after it, and dataState: "all" so fresh days are answered too. Rows are keyed by their dimension values. clicks and impressions are exact integers; ctr and position are Google’s own ratio and average, published as the floating point numbers sent. Google withholds anonymized queries, so query rows do not sum to the day’s totals. settled is Google’s own statement: a day before metadata.first_incomplete_date, or any day when the response names none. Google states data is typically available after two to three days and final data does not change, so restatementDays defaults to five. Pages are startRow offsets of up to 25,000 rows held in the engine-owned position; Search Console states no cursor, and rows of a fresh day can move between two pages of one read. The connection holds a google-search-console OAuth credential (searchConsole.credential, scope webmasters.readonly; a service account added as a property user works through the JWT bearer grant); setup names siteUrl (sc-domain:example.com or a URL-prefix property). Nothing here has run against Google or been qualified.

Provider references

Provider references and prerequisites are maintained in the connector guidance above. No separate provider-documentation review date is recorded.

Source and evidence

Canonical connector source, native analysis and check receipts. Connector artifact: 905888ea276a2a28e36981a79e8142b2547ea451c3e63162cb6915ad4a7d1305. The resource declaration examples above are compiled and compared with exact catalog declarations. Recorded checks apply only to their source, declaration and runtime identities. Configure a connection and inspect its status to establish deployment-specific readiness.

Get Started

Use-case atlas

Platform

Data and Operations

Guides

Client Libraries

Tools

API Reference

Google Search Console

Availability

Resources and modes

Search analytics

daily: Daily search analytics settled by first_incomplete_date

Configuration: queries

Provider guidance

Provider references

Source and evidence

​Availability

​Resources and modes

​Search analytics

​daily: Daily search analytics settled by first_incomplete_date

​Configuration: queries

​Provider guidance

​Provider references

​Source and evidence

Availability

Resources and modes

Search analytics

daily: Daily search analytics settled by first_incomplete_date

Configuration: queries

Provider guidance

Provider references

Source and evidence