Google Contacts

Use the @bijection/connectors/google-contacts entrypoint to declare Google Contacts 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
Contacts	`sync`	People API sync tokens with deleted contacts

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

Contacts

sync: People API sync tokens with deleted contacts

The following example matches configuration standard.

import { googleContacts } from "@bijection/connectors/google-contacts";
export const source = googleContacts.connections.sync();

Inferred record types

Resource without an operational record table

Configuration: standard

Case: google-contacts/connections/sync/standard. Connection and resource configuration are declared by this exact case. Credential kind: google-contacts. Keep credential material in the private credential inventory. Inspect the complete configuration contract below for settings and conditional requirements.

Complete configuration contract

{
  "setup": [],
  "resource": {
    "access": {},
    "defaults": {},
    "connector": "google-contacts",
    "output": {
      "kind": "single",
      "collection": "contacts"
    },
    "credential_kind": "google-contacts",
    "connection_fields": [],
    "address": {
      "kind": "fixed",
      "url": "https://people.googleapis.com/"
    }
  },
  "connection_setup": {
    "type": "object",
    "value": {}
  },
  "execution": null
}

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

Contract	Meaning
Initial	Current membership
Changes	Repeated observations of current records
Deletions	Withdrawal from selected scope
Resume	Opaque cursor
Gap	Explicit repair required after a gap
Retention	Unspecified

Complete native profile

{
  "movement": {
    "exchanges": {
      "connections": {
        "200": {
          "placement": "retained_bytes",
          "interpretation": "json",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "410": {
          "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 connections",
          "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": "current_membership",
  "changes": "observations",
  "deletions": "scope_membership",
  "resume": "opaque_cursor",
  "retentionMs": null,
  "gap": "explicit_repair",
  "limits": {
    "http_response_bytes": "524288",
    "initial_rows": "25000"
  },
  "restrictions": [],
  "commands": {}
}

Commands, occurrences and artifacts

{
  "records": {
    "contacts": {
      "protocol": "record_observation",
      "coverage": "incremental_snapshot",
      "consistency": "observations",
      "atomicity": "record",
      "history": "observations",
      "recordRefresh": false,
      "reconciliation": false,
      "notifications": false,
      "snapshotMaxRows": "25000",
      "profile": {
        "movement": {
          "exchanges": {
            "connections": {
              "200": {
                "placement": "retained_bytes",
                "interpretation": "json",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "410": {
                "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 connections",
                "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": "current_membership",
        "changes": "observations",
        "deletions": "scope_membership",
        "resume": "opaque_cursor",
        "retentionMs": null,
        "gap": "explicit_repair",
        "limits": {
          "http_response_bytes": "524288",
          "initial_rows": "25000"
        },
        "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
incremental-token-reset	{“kind”:“collection”,“name”:“contacts”}	Fixture: ./src/connectors/google-contacts/fixtures/expired-token-resets.json	passed (2026-10-24T21:36:12.058Z)
page-publication-recovery	{“kind”:“collection”,“name”:“contacts”}	Native test: integrations/acquisition/acquisition_windows_preserve_sequences_and_restart_fences_old_work (shared_engine)	Execution result unavailable
stated-cursor-empty-page-advances	{“kind”:“collection”,“name”:“contacts”}	Fixture: ./src/connectors/google-contacts/fixtures/empty-page-advances.json	passed (2026-10-24T21:36:12.058Z)
stated-cursor-repeat-refused	{“kind”:“collection”,“name”:“contacts”}	Fixture: ./src/connectors/google-contacts/fixtures/repeated-page-refused.json	passed (2026-10-24T21:36:12.059Z)
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-contacts/fixtures/identity.json	passed (2026-10-24T21:36:12.059Z)

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. A Google OAuth token with a contacts scope authorizes https://people.googleapis.com/. connections.sync is the People API’s sync-token export. A full pass with requestSyncToken=true establishes the user’s contacts (at most 25,000), and later passes read changes with syncToken, repeated on every page. A contact returned with metadata.deleted: true is withdrawn. An expired token (HTTP 410, EXPIRED_SYNC_TOKEN, seven days after the full sync) resets to a full pass. Writes take minutes to appear in sync results. Read-only. Built from the provider’s published API documentation; nothing here has run against Google Contacts 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

Availability

Resources and modes

Contacts

sync: People API sync tokens with deleted contacts

Configuration: standard

Provider guidance

Provider references

Source and evidence

​Availability

​Resources and modes

​Contacts

​sync: People API sync tokens with deleted contacts

​Configuration: standard

​Provider guidance

​Provider references

​Source and evidence

Availability

Resources and modes

Contacts

sync: People API sync tokens with deleted contacts

Configuration: standard

Provider guidance

Provider references

Source and evidence