Guide

Add Connector - Google Drive

Overview

Airbyte's Google Drive connector enables AI agents and data pipelines to fetch, search, and sync files and metadata from Google Drive in real time. To establish this connection, you must first authenticate with your Google account, explicitly grant Airbyte the necessary permissions to access your Google Drive, and then configure which data categories (drives, files, change history, and account metadata) you want to include in your sync. This one-time setup allows your agents to interact with Google Drive data through strongly typed, documented tools without storing credentials in your application.

Before you begin

  • A Google account with access to Google Drive (the account you will use to authenticate)
  • An active Airbyte workspace where you have permission to add credentials
  • Access to the Airbyte app at app.airbyte.ai with appropriate role permissions (typically Admin or Connector Admin)

Step by step

1
ClickCredentials

Navigate to the Credentials section of Airbyte by clicking the Credentials link in the main navigation. This is where all data source authentication tokens and connector configurations are stored.

Step 1
2
ClickAdd Credential

Click the Add Credential button to initiate the process of creating a new connector credential.

Step 2
3
ClickGoogle Drive

Select Google Drive from the list of available connectors. This tells Airbyte you want to authenticate and configure a Google Drive data source.

Step 3
4
ClickAuthenticate your Google Drive account

Click the Authenticate your Google Drive account button to begin the OAuth flow. This will redirect you to Google's authentication service.

Step 4
5
Switch Tab

Switch to the Google login tab that opens in a new browser tab. This tab contains Google's login and permission consent screens.

Tip. Keep both tabs open (Airbyte and Google) so you can easily return to Airbyte after authentication.
6
Navigate

You are now on the Google Accounts login page. This page allows you to select or log in to your Google account.

7
ClickRahul Arulkumaran rahul@trybrowzer.com

Click on your Google account (rahul@trybrowzer.com in this example) from the list of available accounts. If you only see one account or yours is not listed, you may need to enter your email or log in manually.

Tip. If multiple Google accounts are logged in, ensure you select the correct account that has access to the Google Drive you want to sync.
Step 7
8
Navigate

Google will verify your account and may redirect you to a consent screen. Wait for the page to load completely.

9
ClickContinue

Click the Continue button to proceed past any account verification or initial confirmation screen.

Step 9
10
Navigate

You will now see Google's permission consent screen. Wait for the page to fully load to see all permissions being requested.

11
ClickSelect all

Click the Select all checkbox to grant Airbyte all requested permissions to access your Google Drive, including read and write access to files, folders, and metadata. This is required for the connector to function.

Tip. Review the permissions shown before selecting all. Typical permissions include accessing files, viewing and managing Drive files, and reading account information.
Warning. Granting 'Select all' permissions allows Airbyte to access your entire Google Drive and related metadata. Only proceed if you trust the Airbyte application and your workspace administrators.
Step 11
12
ClickContinue

Click the Continue button to finalize your permission grant and complete the OAuth flow.

Step 12
13
Navigate

Google will redirect you back to the Airbyte application. You should now see the connector configuration form with options to customize your sync settings.

Tip. If you are not redirected automatically, return to the Airbyte tab and refresh the page.
14
Clickgeneric

Click the generic element (a collapsible section or toggle area) to expand or reveal the first data sync option.

Tip. These generic elements are often toggles or expansion buttons that reveal checkboxes for data sync categories.
Step 14
15
ClickInclude Drives

Check the Include Drives checkbox to enable syncing data about all shared drives in your Google account. This option includes drive metadata and structure.

Tip. Enable this only if you need your agents to discover and list shared drives. For personal Drive access, this can remain unchecked.
Step 15
16
Clickgeneric

Click the next generic element to expand or reveal the second data sync option.

Step 16
17
ClickInclude Files

Check the Include Files checkbox to enable syncing file metadata and file contents from Google Drive. This is typically the main data you want to access.

Tip. Enable this option in most cases so your agents can read and interact with files stored in your Google Drive.
Step 17
18
Clickgeneric

Click the next generic element to expand or reveal the third data sync option.

Step 18
19
ClickInclude Changes

Check the Include Changes checkbox to enable syncing change history and revision data from Google Drive. This tracks when files were modified and by whom.

Tip. Enable this option if you need to audit file changes or implement real-time change detection for your workflows.
Step 19
20
Clickgeneric

Click the final generic element to expand or reveal the fourth data sync option.

Step 20
21
ClickInclude About

Check the Include About checkbox to enable syncing account metadata, including information about storage quota, user info, and Drive settings.

Tip. Enable this if you want your agents to check storage usage or access account-level information.
Step 21
22
ClickFolder Url

Click on the Folder Url text field to focus it for input. You will use this field to optionally specify a particular Google Drive folder to restrict data sync scope.

Tip. This field is optional. Leave it blank to sync the entire Google Drive, or enter a specific folder URL to limit syncing to that folder.
Step 22
23
TypeFolder Url

Type the Google Drive folder URL into the Folder Url field. The URL should be in the format https://drive.google.com/drive/folders/{FOLDER_ID}. This restricts the connector to only sync files and metadata from this folder.

Tip. To find your folder URL, open the folder in Google Drive, and copy the URL from the address bar.
Warning. Ensure the folder URL is valid and that your authenticated Google account has access to this folder. An invalid or inaccessible folder URL will cause sync failures.
24
ClickSave

Click the Save button to finalize the Google Drive connector configuration and create the credential. Airbyte will now validate the configuration and store your authenticated Google credentials.

Tip. After saving, the new Google Drive connector credential will appear in your Credentials list and be ready to use in data sources and agent configurations.
Warning. Do not close the browser tab or navigate away before the save completes. Wait for a success message or confirmation before proceeding.
Step 24

Confirm it worked

  1. 1The Google Drive credential appears in your Credentials list with status 'Active' or 'Connected'
  2. 2The connector configuration screen shows all four data sync options (Drives, Files, Changes, About) are either enabled or disabled per your choice
  3. 3A Folder URL is successfully saved and persisted in the configuration (visible in the Folder Url text field)
  4. 4No error messages appear on the screen after clicking Save; you are redirected to the Credentials dashboard

Common issues

Keep reading