> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bijection.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Drive

> Resources, examples, configuration and evidence for Google Drive.

Use the `@bijectionhq/connectors/google-drive` entrypoint to declare Google Drive resources.

## Availability

This page describes the pinned source package. Published availability is unestablished for this artifact. [Source build and package availability](https://docs.bijection.com/client/sdk-distribution.md).

## Resources and modes

| Resource | Mode | Description |
| - | - | - |
| Google Drive | `incremental` | Paged metadata and independent content |
| Google Drive | `references` | Metadata only |

Declare a resource in application code, then bind deployment-specific settings and credentials. See [typed resources](https://docs.bijection.com/integrations/resources.md), [connections](https://docs.bijection.com/integrations/connections.md) and [source inspection](https://docs.bijection.com/integrations/cli.md).

## Google Drive

### incremental: Paged metadata and independent content

The following example matches configuration `standard`.

```ts theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
import { googleDrive } from "@bijectionhq/connectors/google-drive";
export const files = googleDrive.drive.incremental();
```

> **Inferred record types**
>
> ```ts theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
> items: {
>   "id": string;
>   "name": string;
>   "mime_type": string;
>   "provider_version": string;
>   "content_version": string;
>   "downloadable": boolean;
>   "exportable": boolean;
>   "trashed": boolean;
>   "parents": string[];
>   "size": string | undefined;
>   "md5": string | undefined;
>   "web_url": string | undefined;
>   "shortcut_target": string | undefined;
> }
>
> contents: {
>   "id": string;
>   "file": Id<"_storage">;
>   "size": string;
>   "sha256": string;
>   "content_version": string | undefined;
> }
>
> exports: {
>   "id": string;
>   "file": Id<"_storage">;
>   "size": string;
>   "sha256": string;
>   "content_version": string | undefined;
> }
> ```

#### Configuration: standard

Case: `google-drive/drive/incremental/standard`.

Connection and resource configuration are declared by this exact case.

Credential kind: `google-drive`. Keep credential material in the private credential inventory.

| Setting | Type | Required | Owner |
| - | - | - | - |
| `driveId` | string | Yes | Resource binding |

> **Complete configuration contract**
>
> ```json theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
> {
>   "setup": [],
>   "resource": {
>     "access": {},
>     "defaults": {},
>     "connector": "google-drive",
>     "output": {
>       "kind": "bundle",
>       "collections": [
>         "contents",
>         "exports",
>         "items"
>       ]
>     },
>     "credential_kind": "google-drive",
>     "connection_fields": [],
>     "address": {
>       "kind": "fixed",
>       "url": "https://www.googleapis.com/drive/v3"
>     }
>   },
>   "connection_setup": {
>     "type": "object",
>     "value": {
>       "driveId": {
>         "fieldType": {
>           "type": "string"
>         },
>         "optional": false
>       }
>     }
>   },
>   "execution": null
> }
> ```

Native admission analysis has not been recorded for this artifact. Declared configuration does not establish native guarantees or provider behavior.

**Recorded checks**

| Requirement | Scope | Evidence | Result |
| - | - | - | - |
| page-publication-recovery | \{"kind":"collection","name":"contents"} | Provider behavior and native admission require exact-source remote receipts; no live provider account has been reached. | Execution result unavailable |
| page-publication-recovery | \{"kind":"collection","name":"exports"} | Provider behavior and native admission require exact-source remote receipts; no live provider account has been reached. | Execution result unavailable |
| page-publication-recovery | \{"kind":"collection","name":"items"} | Provider behavior and native admission require exact-source remote receipts; no live provider account has been reached. | Execution result unavailable |
| identity-account | \{"kind":"connection"} | Provider behavior and native admission require exact-source remote receipts; no live provider account has been reached. | Execution result unavailable |

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

#### Configuration: pdfExports

Case: `google-drive/drive/incremental/pdfExports`.

Connection and resource configuration are declared by this exact case.

Credential kind: `google-drive`. Keep credential material in the private credential inventory.

| Setting | Type | Required | Owner |
| - | - | - | - |
| `driveId` | string | Yes | Resource binding |

> **Complete configuration contract**
>
> ```json theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
> {
>   "setup": [],
>   "resource": {
>     "access": {},
>     "defaults": {},
>     "connector": "google-drive",
>     "output": {
>       "kind": "bundle",
>       "collections": [
>         "contents",
>         "exports",
>         "items"
>       ]
>     },
>     "credential_kind": "google-drive",
>     "connection_fields": [],
>     "address": {
>       "kind": "fixed",
>       "url": "https://www.googleapis.com/drive/v3"
>     }
>   },
>   "connection_setup": {
>     "type": "object",
>     "value": {
>       "driveId": {
>         "fieldType": {
>           "type": "string"
>         },
>         "optional": false
>       }
>     }
>   },
>   "execution": null
> }
> ```

Native admission analysis has not been recorded for this artifact. Declared configuration does not establish native guarantees or provider behavior.

**Recorded checks**

| Requirement | Scope | Evidence | Result |
| - | - | - | - |
| page-publication-recovery | \{"kind":"collection","name":"contents"} | Configured Workspace exports require exact-source native and provider evidence. | Execution result unavailable |
| page-publication-recovery | \{"kind":"collection","name":"exports"} | Configured Workspace exports require exact-source native and provider evidence. | Execution result unavailable |
| page-publication-recovery | \{"kind":"collection","name":"items"} | Configured Workspace exports require exact-source native and provider evidence. | Execution result unavailable |
| identity-account | \{"kind":"connection"} | Configured Workspace exports require exact-source native and provider evidence. | Execution result unavailable |

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

### references: Metadata only

The following example matches configuration `standard`.

```ts theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
import { googleDrive } from "@bijectionhq/connectors/google-drive";
export const files = googleDrive.drive.references();
```

> **Inferred record types**
>
> ```ts theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
> items: {
>   "id": string;
>   "name": string;
>   "mime_type": string;
>   "provider_version": string;
>   "content_version": string;
>   "downloadable": boolean;
>   "exportable": boolean;
>   "trashed": boolean;
>   "parents": string[];
>   "size": string | undefined;
>   "md5": string | undefined;
>   "web_url": string | undefined;
>   "shortcut_target": string | undefined;
> }
> ```

#### Configuration: standard

Case: `google-drive/drive/references/standard`.

Connection and resource configuration are declared by this exact case.

Credential kind: `google-drive`. Keep credential material in the private credential inventory.

| Setting | Type | Required | Owner |
| - | - | - | - |
| `driveId` | string | Yes | Resource binding |

> **Complete configuration contract**
>
> ```json theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
> {
>   "setup": [],
>   "resource": {
>     "access": {},
>     "defaults": {},
>     "connector": "google-drive",
>     "output": {
>       "kind": "bundle",
>       "collections": [
>         "items"
>       ]
>     },
>     "credential_kind": "google-drive",
>     "connection_fields": [],
>     "address": {
>       "kind": "fixed",
>       "url": "https://www.googleapis.com/drive/v3"
>     }
>   },
>   "connection_setup": {
>     "type": "object",
>     "value": {
>       "driveId": {
>         "fieldType": {
>           "type": "string"
>         },
>         "optional": false
>       }
>     }
>   },
>   "execution": null
> }
> ```

Native admission analysis has not been recorded for this artifact. Declared configuration does not establish native guarantees or provider behavior.

**Recorded checks**

| Requirement | Scope | Evidence | Result |
| - | - | - | - |
| page-publication-recovery | \{"kind":"collection","name":"items"} | Reference mode declares no content downloads; hosted behavior remains unestablished. | Execution result unavailable |
| identity-account | \{"kind":"connection"} | Reference mode declares no content downloads; hosted behavior remains unestablished. | Execution result unavailable |

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

## Provider guidance

```ts theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
import { googleDrive } from "@bijectionhq/connectors/google-drive";
export const files = googleDrive.drive.incremental({
  exportMimeType: "application/pdf",
});
```

Bind `driveId` to a shared drive ID, or the empty string for the authenticated
user's accessible files. The private `google-drive` OAuth credential needs
`https://www.googleapis.com/auth/drive.readonly`. This mode does not claim that
a `drive.file` grant can enumerate an entire drive. Consent and account
selection remain deployment configuration.

The reader saves a startPageToken before listing files, publishes bounded pages,
then reads changes from that saved token to catch edits made during the listing.
It stores nextPageToken and newStartPageToken without ordering or incrementing
them. Empty continuation pages still advance. A 410 explicitly restarts
bootstrap; other failures retain the previous position. Incomplete searches are
refused. None of these pages claims a transactionally consistent multi-page
snapshot or a complete historical change log.

File IDs remain the record identity across renames and moves. `items` retains
names, parent IDs, MIME type, provider version, content fingerprint, size,
shortcut target and download capability. Removal means removal from this
source's visible scope, not proof of permanent deletion. Shortcuts are
references; this mode does not follow arbitrary targets.

`contents` copies downloadable blob files using files.get?alt=media. With an
explicit `exportMimeType`, `exports` separately acquires downloadable Workspace
documents through files.export, subject to Google's 10 MiB export limit.
Unsupported export formats remain unresolved. Exports retain their explicit
representation; they are not original file bytes. Metadata and byte acquisition
have independent schedules and durable responsibilities. Host-computed SHA-256
identifies acquired bytes. Provider MD5 and opaque revisions keep separate
names.

`googleDrive.drive.references()` declares only metadata endpoints and needs the
narrower `drive.metadata.readonly` OAuth scope. It exposes no content or export
table. The protected file ceiling is 1 GiB (256 MiB by default). A refused or
incomplete transfer leaves work pending. Provider capabilities are observed
metadata and do not become application ACLs. This is an application-governed,
read-only mode; no live Drive qualification is established by declaration export
or portable fixtures.

## 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](https://github.com/bijectionhq/component-support/blob/80d6b8b52265070a1008a58e4a99df086f94771a/packages/connectors/src/connectors/google-drive/README.md), [native analysis](https://github.com/bijectionhq/component-support/blob/80d6b8b52265070a1008a58e4a99df086f94771a/packages/connectors/contract-analysis.json) and [check receipts](https://github.com/bijectionhq/component-support/blob/80d6b8b52265070a1008a58e4a99df086f94771a/packages/connectors/evidence.json).

Connector artifact: `4f299f628dc463dd516cd6941e78813d3b2e27f88a9a37a14af7837a20805b62`.

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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.