Google Drive

Configuration

Google Drive source connector integrates with the Google Drive API to extract files.

Supports both personal Google Drive (My Drive) and shared drives.

It supports downloading and processing files while maintaining proper organization and access permissions.

Explore the Google Drive connector implementation

Authentication

This connector uses OAuth 2.0 with custom credentials. You need to provide your OAuth application’s Client ID and Client Secret, then complete the OAuth consent flow.

OAuth Setup Required

Create an OAuth application in your provider’s developer console
Enter your Client ID and Client Secret when configuring the connection
Complete the OAuth consent flow

Configuration Options

The following configuration options are available for this connector:

Configuration Parameters

Google Drive configuration schema.

include_patterns

list[str]Defaults to []

List of file/folder paths to include in synchronization. Examples: ‘my_folder/*’, ‘my_folder/my_file.pdf’. Separate multiple patterns with commas. If empty, all files are included.

Data Models

The following data models are available for this connector:

GoogleDriveDriveEntity

Schema for a Drive resource (shared drive).

Reference: https://developers.google.com/drive/api/v3/reference/drives

Field	Type	Description
drive_id	str	Unique ID of the shared drive.
name	Optional[str]	The name of this shared drive.
kind	Optional[str]	Identifies what kind of resource this is; typically “drive#drive”.
color_rgb	Optional[str]	The color of this shared drive as an RGB hex string.
created_time	Optional[datetime]	When the shared drive was created (RFC 3339 date-time).
hidden	bool	Whether the shared drive is hidden from default view.
org_unit_id	Optional[str]	The organizational unit of this shared drive, if applicable.

GoogleDriveFileEntity

Schema for a File resource (in a user’s or shared drive).

Reference: https://developers.google.com/drive/api/v3/reference/files

Field	Type	Description
file_id	str	Unique ID of the file.
name	Optional[str]	Name of the file.
mime_type	Optional[str]	MIME type of the file.
description	Optional[str]	Optional description of the file.
starred	bool	Indicates whether the user has starred the file.
trashed	bool	Whether the file is in the trash.
explicitly_trashed	bool	Whether the file was explicitly trashed by the user.
parents	List[str]	IDs of the parent folders containing this file.
shared	bool	Whether the file is shared.
web_view_link	Optional[str]	Link for opening the file in a relevant Google editor or viewer.
icon_link	Optional[str]	A static, far-reaching URL to the file’s icon.
created_time	Optional[datetime]	When the file was created (RFC 3339 date-time).
modified_time	Optional[datetime]	When the file was last modified (RFC 3339 date-time).
size	Optional[int]	The size of the file’s content in bytes.
md5_checksum	Optional[str]	MD5 checksum for the content of the file.

GoogleDriveFileDeletionEntity

Deletion signal for a Google Drive file.

Emitted when the Drive Changes API reports a file was removed (deleted or access lost). The entity_id matches the original file’s file_id used for GoogleDriveFileEntity so downstream deletion can target the correct parent/children.

Field	Type	Description
file_id	str	ID of the deleted file
deletion_status	str	Status indicating the file was removed (e.g., ‘removed’)

Integrate Airweave with Google APIs on localhost

This guide will walk you through connecting Google Workspace APIs to Airweave when running locally. Google provides extensive documentation on setting up your workspace. Below is a streamlined process for connecting Google APIs to Airweave.

Create a Google Cloud project for your Google Workspace (if you don’t already have one)
Enable the Google Workspace APIs for Gmail, Google Calendar, and Google Drive
Configure Google OAuth 2.0 consent screen
Under Audience, select Make external and add test users
Under Data Access, add the following scopes:

https://www.googleapis.com/auth/docs
https://www.googleapis.com/auth/drive.photos.readonly
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/gmail.readonly
https://www.googleapis.com/auth/calendar.events.public.readonly
https://www.googleapis.com/auth/calendar.freebusy
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar.calendars.readonly
https://www.googleapis.com/auth/calendar.events.owned.readonly
https://www.googleapis.com/auth/calendar.events.readonly

Create OAuth client ID credentials

Under “Authorized redirect URIs,” click ”+ Add URI” and add the Redirect URI. Use the appropriate URL for your environment: Production (Airweave Cloud):

https://api.airweave.ai/source-connections/callback

Local:

http://localhost:8001/source-connections/callback

Locate the client ID and client secret from your newly created OAuth client. Add these credentials to the dev.integrations.yml file to enable Google API integration.