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

# Source: Google Drive

> Connect Google Drive as a source.

Checked on Izumi 0.5.7, 2026-11-21.

A **Google Drive** source reads folders and files from Drive and imports them into the domains of the company. Izumi only reads (`drive.readonly`) and never changes files. You choose what is read, what is imported and into which domain it goes, and what is left out. Before the first import, the **Dry run** shows what would be imported, without any change in Izumi.

## Before you start

* You must be a company admin. The **Sources** and **Import report** pages are visible only to admins.
* The company must have at least one domain. Without a domain, **Import rules** says: *"The company has no live domain. Create one on the Companies and members screen."*
* The Google account you connect with must see the folders you want. The rules tree shows the whole **My Drive** of that account, not only what you will import. Connect an account that sees only what it is allowed to see.
* Changing sharing in Drive does not change access in Izumi. Access is decided by domains and roles.
* This installation has its own Google client, so you create nothing in Google Cloud. If your company wants its own client, enter it under **OAuth client of your own (advanced)** (from the code).

> [!WARNING]
>
> The rules tree shows the whole My Drive of the connected account, including personal folders and other people's folders. For a client account, connect a separate account or an account that has access only to the folders you need.

## Connect Drive

**1. Add a source**

Open **Sources** and click **Add source**. The types offered are **Upload**, **Google Drive** and **SharePoint/OneDrive**.

![Izumi, choosing the source type](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/sources-drive/01-add-source.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=558c20778578645fee3cfbea78b97594)

**2. Choose Google Drive**

The dialog **Connect Google Drive** has the field **Source name** and the folded section **OAuth client of your own (advanced)**. Enter a name and click **Connect Google Drive**.

![Izumi, Connect Google Drive dialog](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/sources-drive/02-drive-connect.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=17555ec5de7a22d0d458c553d19f5222)

**3. Grant read access in Google**

Google asks you to choose an account and grant read-only access. For now Google shows a warning that the app is not verified. That is expected: click "Advanced" and continue to Izumi. We did not capture these Google screens.

**4. Choose what Izumi may read**

After approval you return to **Sources**. The new card has the label **New** and a **Connected** row with the account address. Under **What Izumi may read** select **My Drive** and click **Save scope**. If nothing is selected, it says *"Choose at least one root."*

![Izumi, choosing the scope of the source](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/sources-drive/03-scope.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=eff9a8619fb65758ddf87b1e0648dc47)

## Set the import rules

**1. Choose folders and domains**

Under **Import rules** open **My Drive** and go down through the folders. Each folder or file has a checkbox (include), a domain menu (required, only live domains of the company are offered), **With subfolders** and **Exclude**. Below the tree is the list **Selected** with **Remove**.

![Izumi, import rules tree](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/sources-drive/04-rules-editor.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=acfe6c0efb129f581974aba5d36b5788)

**2. Add filters (optional)**

* **File types**: `doc`, `sheet`, `slides`, `docx`, `xlsx`, `csv`, `pdf`, `md`, `txt`. If nothing is selected, all supported types are imported.
* **Include names (patterns)** and **Exclude names (patterns)**: one pattern per line, up to 200 characters, for example `*.md`.
* **Modified from (inclusive)** and **Modified until (exclusive)**. An empty date means no limit.

**3. Save the rules**

**Save rules** opens the confirmation **Save the rules?** with a number: *"The next sync removes 0 documents from Izumi and adds 6."* After saving it says *"Rules saved. A new dry run checks them before the import."*

![Izumi, confirmation of saving the rules](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/sources-drive/05-save-rules.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=f691207b6b06a2bf469a9e9972bc7c4f)

Messages you may see when saving:

* *"Nothing is selected, so nothing is imported."* Select at least one folder or file.
* *"Choose a domain for every selected folder and file."* Every selected item needs a domain.
* *"The start date must be before the end date."* Fix the dates.

## Dry run and first import

**1. Wait for the dry run**

As soon as you save the scope or the rules, the dry run starts by itself. The card says **Dry run in progress**: *"The dry run reads the source. Nothing changes in Izumi."* The tree fills in only when the dry run ends.

![Izumi, dry run in progress](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/sources-drive/06-dry-run-progress.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=de5eeacee28759eedee1960f45e7e407)

**2. Read the result**

The **Dry run** section shows the time of the last dry run, the line "To import" (number of files and size), the tables **By domain** and **By type**, then the counts of unsupported files, files that are too large, files excluded by the rules and the estimated import time. The card says **Dry run ready**.

![Izumi, dry run result](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/sources-drive/07-dry-run-result.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=49f53068015de96011eab36f39d4d35d)

![Izumi, source card after the dry run](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/sources-drive/08-dry-run-ready.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=3c770c9a5ca9549d124afd3543095f89)

**3. Start the import**

**Start import** is off until the dry run on the current rules has ended. After every change of the rules or the scope the section says *"The rules or the scope changed after this dry run. Run a new one before the import."* The card shows **Sync in progress**, then **OK** and the number of **Documents**. In our tests 5 to 6 documents took about a minute.

![Izumi, import in progress](https://mintcdn.com/akia-consulting/RvQAknt4j1yWbS4K/images/en/sources-drive/09-sync-running.png?fit=max\&auto=format\&n=RvQAknt4j1yWbS4K\&q=85\&s=92a1745f9d4e403c7ce592f15b36c77c)

![Izumi, import finished](https://mintcdn.com/akia-consulting/RvQAknt4j1yWbS4K/images/en/sources-drive/10-sync-done.png?fit=max\&auto=format\&n=RvQAknt4j1yWbS4K\&q=85\&s=a109f422dfebfa647825aa86167ceb56)

**4. Set the check**

After the first import the button becomes **Import now**, and the **Check** field sets how often Izumi checks Drive: 5, 15, 30, 60 minutes, 6 hours or 24 hours, 15 minutes by default (from the code). **Next sync** shows when the next check is.

## Actions on the card

**1. Buttons on the card**

The card has **Dry run**, **Import now**, **Pause**, **Rules and scope** (opens and closes the rules, **Close rules**) and the three-dot menu.

![Izumi, actions on the source card](https://mintcdn.com/akia-consulting/RvQAknt4j1yWbS4K/images/en/sources-drive/11-card-actions.png?fit=max\&auto=format\&n=RvQAknt4j1yWbS4K\&q=85\&s=0a1f285519ea4c6886efb584898b6c41)

**2. Pause a source**

**Pause** adds the label **Paused**. **Dry run** and **Import now** turn off, **Next sync** is empty and the button becomes **Resume**. **Resume** brings back the state **OK**.

![Izumi, paused source](https://mintcdn.com/akia-consulting/RvQAknt4j1yWbS4K/images/en/sources-drive/12-paused.png?fit=max\&auto=format\&n=RvQAknt4j1yWbS4K\&q=85\&s=4890645670b2960513a76578d063d1f6)

**3. Delete a source**

The three-dot menu has **Delete source**. The confirmation **Delete the source?** says: *"The source "…" and all the documents it imported (N documents) will be removed from Izumi. This cannot be undone."* Click **Delete**. The message is *"The source was deleted."* Deleting also removes the source's rows from **Import report**. While an import is running, the delete is refused (from the code). The files in Drive stay untouched.

![Izumi, source menu](https://mintcdn.com/akia-consulting/RvQAknt4j1yWbS4K/images/en/sources-drive/13-source-menu.png?fit=max\&auto=format\&n=RvQAknt4j1yWbS4K\&q=85\&s=1f0ccb8af3dd2422543c9b45cdf0b016)

![Izumi, confirmation of deleting a source](https://mintcdn.com/akia-consulting/RvQAknt4j1yWbS4K/images/en/sources-drive/14-delete-dialog.png?fit=max\&auto=format\&n=RvQAknt4j1yWbS4K\&q=85\&s=2e32d20a680a64dfbb2cdae86256c200)

## Import report

**1. Open the list of imports**

Choose **Import report** in the left menu. The table has the columns **Source**, **Kind** (**Scheduled**, **Manual**, **Dry run**, **Upload**), **Start**, **Duration**, **Counts**, **Status** (**Finished**, **Running**, **Failed**) and **Actions**. When nothing changed, it says **Nothing to import**. A scheduled check adds one row each time. The screenshot leaves out the **Duration** and **Actions** columns so it stays readable.

![Izumi, import report](https://mintcdn.com/akia-consulting/RvQAknt4j1yWbS4K/images/en/sources-drive/15-import-runs.png?fit=max\&auto=format\&n=RvQAknt4j1yWbS4K\&q=85\&s=caa3757baedce46bd4d5c5a149ef87da)

**2. Open one import**

**Open** gives the totals per outcome, the filter **Outcome**, **Download CSV** and the table **Path**, **Type**, **Size**, **Domain**, **Outcome**, **Reason**. The outcomes are **Added**, **Updated**, **Unchanged**, **Removed**, **Excluded**, **Skipped: unsupported type**, **Skipped: no text**, **Skipped: too large** and **Failed**. Only **Added** was seen live, the other outcomes are from the code. **Back to imports** returns to the list. The screenshot leaves out the **Reason** column.

![Izumi, detail of one import](https://mintcdn.com/akia-consulting/RvQAknt4j1yWbS4K/images/en/sources-drive/16-run-detail.png?fit=max\&auto=format\&n=RvQAknt4j1yWbS4K\&q=85\&s=9f255d5422abbba5007e6409daf856fe)

## Limits

* Read-only. Izumi never changes files in Drive.
* A file larger than 50 MB is skipped as too large (from the code).
* Only the types in the **File types** list are imported. Everything else is counted as unsupported.
* Only **My Drive** was checked. Shared drives were not checked.
* Sources in a company can share the same Google account. Revoking access on the Google account switches off the tokens of all sources that share the client and the account (Google behavior, not checked live).
* While an import or a dry run is in progress, the scope, the rules and the connection cannot change: *"A sync or dry run of this source is already in progress. The card shows when it ends."* (from the code)

> [!WARNING]
>
> Not checked live yet: the state **Reconnect required** with the button **Reconnect**, the state **Error** with automatic retry, shared drives, an OAuth client of your own and the Google warning screen. The descriptions of those states are from the code.

## Troubleshooting

* *"The connection attempt expired. Try again."* The approval window was open too long. Repeat **Connect Google Drive** (from the code).
* *"Access was denied on the Google screen."* You declined or closed the Google screen. Repeat and grant read access (from the code).
* *"Read access to Drive was not granted. Grant it and try again."* The Drive read access was left unchecked on the Google screen (from the code).
* *"Google did not return a lasting permission. Try again."* Repeat the connection (from the code).
* *"Connecting failed. Try again."* A general error. If it repeats, the most common cause is the Drive API switched off in the Google Cloud project of your own OAuth client (from the code and the install guide).
* The label **Reconnect required** with the message *"Reconnect to resume the sync."* Google refused the stored token (revoked, expired, password change). Click **Reconnect** (from the code).
* The label **Error** with *Last error: …* and *Next attempt: …* A temporary error, for example Google is unavailable. Izumi retries by itself (from the code).
* **Start import** is gray. The dry run on the current rules is not finished. Wait for it or click **Dry run**.
* The dry run reports 0 files. The rules are empty, or the types and patterns exclude everything.


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