> Index of every Falcon docs page, for assistants: https://falcon.com/docs/llms.txt

# Google Drive

Find, download, export and upload files in Google Drive, read who can open them, and start a workflow when a file changes.

## What it can do

- Read: **Get account**, **List files**, **Get file**, **Download file**, **Export file**, **List permissions**, **Get permission**, **List shared drives**, **Get shared drive**, **Get changes start token**, **List changes**, **List comments** and **List revisions**.
- Change files: **Create folder**, **Create file**, **Copy file**, **Update file**, **Upload file**, **Replace file content**, **Watch changes**, **Watch file** and **Stop notifications**.

Docs, Sheets and Slides have no bytes on **Download file**. Use **Export file**. An export is at most 10 MB. An upload is at most 5 MB. **Update file** can move a file to trash, and that can be undone. This app can read who has access. It cannot grant, change or remove access, and it does not delete files forever. One list is one page, not the whole drive.

## What can start a workflow

- **Drive change**, **File added**, **File updated**, **File trashed**, **File untrashed**, **File removed** and **Channel sync**.
- The notice does not include the file. **List changes** or **Get file** reads it. Studio checks the channel it created before it treats the notice as real.
- A file watch lasts at most 1 day. A drive watch lasts at most 7 days. Both last 1 hour unless an end time is set. Renew by watching again, then stop the old one.

## How to connect

Open **Connections**, then **Apps**. In the **Apps** heading, search with **Search apps to add** and choose **Add** on Google Drive.

When the panel offers **Who signs in**, pick **Sign in as the company (one account for every agent)** or **Each person signs in to their own account when first needed**.

Read what it asks for. If it has not said, the panel says **You'll see what Google Drive asks for on its own sign-in page.** Choose **Continue to Google Drive** and finish there. Do not paste a password into Studio. When it works, the row says **Connected**.

If it says **This app can't be connected here yet: it needs a sign-in setup this server doesn't have.** or **Connecting Google Drive opens soon on this server.**, this server cannot sign Google Drive in yet. If you do not see **Add**, ask an admin to add Google Drive.

## What it asks for

- Create files, and open files this app created or the person picked for it (`drive.file`). This alone cannot search the rest of the drive.
- List, search, download and read permissions for files this account can already open, including shared drives (`drive.readonly`).
- It does not ask for full drive access (`https://www.googleapis.com/auth/drive`).

## Related

- [Gmail](https://falcon.com/docs/app-gmail)
- [Google Calendar](https://falcon.com/docs/app-google-calendar)
- [Connections](https://falcon.com/docs/connections)