Google Docs

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

• Create, update, list, and delete documents

Available Tools

These tools are currently available in the Arcade Google Docs toolkit.

GoogleDocs.GetDocumentById

Get the latest version of the specified Google Docs document.

Parameters

• document_id (string, required) The ID of the document to retrieve.

GoogleDocs.InsertTextAtEndOfDocument

Insert text at the end of an existing Google Docs document.

Parameters

• document_id (string, required) The ID of the document to update.
• text_content (string, required) The text content to insert into the document.

GoogleDocs.CreateBlankDocument

Create a blank Google Docs document with the specified title.

Parameters

• title (string, required) The title of the blank document to create.

GoogleDocs.CreateDocumentFromText

Create a Google Docs document with the specified title and text content.

Parameters

• title (string, required) The title of the document to create.
• text_content (string, required) The text content to insert into the document.

GoogleDocs.SearchDocuments

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

Parameters

• document_contains (list[str], optional) Keywords or phrases that must be in the document title or body. Provide a list of keywords or phrases if needed.
• document_not_contains (list[str], optional) Keywords or phrases that must not be in the document title or body. Provide a list of keywords or phrases if needed.
• search_only_in_shared_drive_id (str, optional) The ID of the shared drive to restrict the search to. If provided, the search will only return documents from this drive. Defaults to None, which searches across all drives.
• include_shared_drives (bool, optional) Whether to include documents from shared drives in the search results. Defaults to False (searches only in the user’s ‘My Drive’).
• 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 documents to list. Defaults to 50.
• pagination_token (str, optional) The pagination token to continue a previous request

GoogleDrive.SearchAndRetrieveDocuments

Searches for documents in the user’s Google Drive and returns a list of documents (with text content) matching the search criteria. Excludes documents that are in the trash.

Parameters

• document_format (enum (DocumentFormat), optional) The format of the document to be returned. Defaults to Markdown.
• document_contains (list[str], optional) Keywords or phrases that must be in the document title or body. Provide a list of keywords or phrases if needed.
• document_not_contains (list[str], optional) Keywords or phrases that must not be in the document title or body. Provide a list of keywords or phrases if needed.
• search_only_in_shared_drive_id (str, optional) The ID of the shared drive to restrict the search to. If provided, the search will only return documents from this drive. Defaults to None, which searches across all drives.
• include_shared_drives (bool, optional) Whether to include documents from shared drives in the search results. Defaults to False (searches only in the user’s ‘My Drive’).
• 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 documents to list. Defaults to 50.
• pagination_token (str, optional) The pagination token to continue a previous request

Auth

The Arcade Docs 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.

Reference

DocumentFormat

The format of the document to be returned.

• MARKDOWN: Markdown format.
• HTML: HTML format.
• GOOGLE_API_JSON: Original JSON format returned by the Google API.

OrderBy

Sort keys for ordering files in Google Drive. Each key has both ascending and descending options.

• CREATED_TIME: When the file was created (ascending).
• CREATED_TIME_DESC: When the file was created (descending).
• FOLDER: The folder ID, sorted using alphabetical ordering (ascending).
• FOLDER_DESC: The folder ID, sorted using alphabetical ordering (descending).
• MODIFIED_BY_ME_TIME: The last time the file was modified by the user (ascending).
• MODIFIED_BY_ME_TIME_DESC: The last time the file was modified by the user (descending).
• MODIFIED_TIME: The last time the file was modified by anyone (ascending).
• MODIFIED_TIME_DESC: The last time the file was modified by anyone (descending).
• NAME: The name of the file, sorted using alphabetical ordering (ascending).
• NAME_DESC: The name of the file, sorted using alphabetical ordering (descending).
• NAME_NATURAL: The name of the file, sorted using natural sort ordering (ascending).
• NAME_NATURAL_DESC: The name of the file, sorted using natural sort ordering (descending).
• QUOTA_BYTES_USED: The number of storage quota bytes used by the file (ascending).
• QUOTA_BYTES_USED_DESC: The number of storage quota bytes used by the file (descending).
• RECENCY: The most recent timestamp from the file’s date-time fields (ascending).
• RECENCY_DESC: The most recent timestamp from the file’s date-time fields (descending).
• SHARED_WITH_ME_TIME: When the file was shared with the user, if applicable (ascending).
• SHARED_WITH_ME_TIME_DESC: When the file was shared with the user, if applicable (descending).
• STARRED: Whether the user has starred the file (ascending).
• STARRED_DESC: Whether the user has starred the file (descending).
• VIEWED_BY_ME_TIME: The last time the file was viewed by the user (ascending).
• VIEWED_BY_ME_TIME_DESC: The last time the file was viewed by the user (descending).

pip install arcade_google_docs