Google Drive integration

Pick the right file set

Supported document and PDF content

Connection planning checklist

• A Google account with access to the intended files.
• Permission to connect that account under your organization’s policy.
• A MemorySync project for the imported document knowledge.

File synchronization lifecycle

1. 1
   Connect an account

   Use an account that can access the intended files.

2. 2
   Select or confirm access

   Keep the available file set aligned with the use case.

3. 3
   Extract and synchronize

   Process supported documents, PDFs, and metadata through synchronization.

4. 4
   Retrieve

   Query the imported document knowledge.

Extractable and non-extractable content

Verify document retrieval

Query a distinctive phrase from a known supported document or PDF that the connected account can open. Confirm the result is from the intended file set.

Troubleshooting and related sources

Operations on this page

Authentication and scope

Before you start

You need an active Google Drive connection from the OAuth flow on Providers & OAuth. Drive cannot be connected with an API key.

1. Get the picker configuration

Returns what the browser-side Google Picker needs: the app id, the developer key, and the OAuth token scoped to this connection. Fetching it from your server and handing it to the picker means your page never holds a long-lived Google credential.

import os
from memorysync import MemorySyncClient

client = MemorySyncClient(
    api_key=os.environ["MEMORYSYNC_API_KEY"],
    base_url="https://api.memorysync.io",
)

config = client.connections.gdrive.picker_config("conn_8f21a4")
# Serialise this to the browser that renders the picker.
print(config["app_id"], config["client_id"], config["scope"])

2. Select files and folders

Selecting a folder selects its contents, and MemorySync keeps following that folder — files added to it later are picked up by later syncs. Selecting a file selects only that file.

import os
from memorysync import MemorySyncClient

client = MemorySyncClient(
    api_key=os.environ["MEMORYSYNC_API_KEY"],
    base_url="https://api.memorysync.io",
)

client.connections.gdrive.add_resources(
    "conn_8f21a4",
    resources=[
        {"id": "1AbCdEfGhIjKlMnOpQrStUvWxYz", "type": "folder", "name": "Handbook"},
        {"id": "1ZyXwVuTsRqPoNmLkJiHgFeDcBa", "type": "file", "name": "Pricing.pdf"},
    ],
)

3. Read back the selection

Like the Slack channel list, this returns a bare JSON array rather than an object with a resources key.

import os
from memorysync import MemorySyncClient

client = MemorySyncClient(
    api_key=os.environ["MEMORYSYNC_API_KEY"],
    base_url="https://api.memorysync.io",
)

for resource in client.connections.gdrive.resources("conn_8f21a4"):
    print(resource["resource_id"], resource["resource_type"], resource["name"], resource["permission_state"])

4. Sync and check the formats

Trigger a sync on Sync & Jobs. Google-native documents are exported before parsing; binary formats are parsed as they are. A format with no parser produces an object with no memories rather than an error, which is why an empty result is worth checking rather than assuming a failure.

5. Deselect a resource

Stops future syncs reading it. Existing objects and memories are kept.

import os
from memorysync import MemorySyncClient

client = MemorySyncClient(
    api_key=os.environ["MEMORYSYNC_API_KEY"],
    base_url="https://api.memorysync.io",
)

client.connections.gdrive.remove_resource("conn_8f21a4", "1ZyXwVuTsRqPoNmLkJiHgFeDcBa")

Errors and next action