IntegrationsProductivity & DocsGoogleDrive

Drive

Description: Enable agents to interact with Google Drive.

Author: Arcade

Code: GitHub

Auth: User authorization via the Google auth provider

PyPI VersionLicensePython VersionsWheel StatusDownloads

The Arcade Drive toolkit provides a pre-built set of tools for interacting with Google Drive. These tools make it easy to build agents and AI apps that can:

  • List Google documents in the user’s Google Drive

Install

pip install arcade_google

Available Tools

Tool NameDescription
ListDocumentsList documents in the user's Google Drive. Note: This tool currently requires a self-hosted instance of Arcade.

If you need to perform an action that’s not listed here, you can get in touch with us to request a new tool, or create your own tools with the Google auth provider.

ListDocuments


List documents in the user’s Google Drive. Excludes documents that are in the trash.

Parameters

  • corpora (enum (Corpora), optional) The source of files to list. Defaults to Corpora.USER.
  • title_keywords (list[str], optional) Keywords or phrases that must be in the document title. Defaults to None.
  • order_by (enum (OrderBy), optional) Sort order. Defaults to OrderBy.MODIFIED_TIME_DESC.
  • supports_all_drives (bool, optional) Whether the requesting application supports both My Drives and shared drives. Defaults to False.
  • limit (int, optional) The number of documents to list. Defaults to 50.

GetFileTreeStructure


Get the file/folder tree structure of the user’s Google Drive.

Parameters

  • include_shared_drives (bool, optional) Whether to include shared drives in the file tree structure. Defaults to False.
  • restrict_to_shared_drive_id (str, optional) If provided, only include files from this shared drive in the file tree structure. Defaults to None, which will include files and folders from all drives.
  • include_organization_domain_documents (bool, optional) Whether to include documents from the organization’s domain. This is applicable to admin users who have permissions to view organization-wide documents in a Google Workspace account. Defaults to False.
  • order_by (enum (OrderBy), optional) Sort order. Defaults to listing the most recently modified documents first.
  • limit (int, optional) The number of files and folders to list. Defaults to None, which will list all files and folders.

Auth

The Arcade Drive toolkit uses the Google auth provider to connect to users’ Google accounts.

With the hosted Arcade Engine, there’s nothing to configure. Your users will see Arcade as the name of the application that’s requesting permission.

With a self-hosted installation of Arcade, you need to configure the Google auth provider with your own Google app credentials.