> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Drive

> How to set up the Google Drive connector, plus the actions and events that are available.

![Google Drive](https://stackone-logos.com/api/google-drive/filled/svg)

v4.0.0[See changelog](https://docs.stackone.com/connectors/googledrive/changelog.md)

[64 actions](#actions) · [2 events](#events) · 1 auth method

Storage
IAM

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/googledrive/guides/connector-profile/oauth-2-0.md)
>
> Requires creating an OAuth client in a Google Cloud project. Defaults to full Drive access; IAM actions also need Admin...

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/googledrive/guides/link-account/oauth-2-0.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Scopes

Select all
|
Clear

https\://​www\.googleapis.com/auth/admin.directory.domain.readonly

https\://​www\.googleapis.com/auth/admin.directory.group.readonly

https\://​www\.googleapis.com/auth/admin.directory.user.readonly

https\://​www\.googleapis.com/auth/drive

https\://​www\.googleapis.com/auth/drive.file

https\://​www\.googleapis.com/auth/drive.metadata.readonly

https\://​www\.googleapis.com/auth/drive.readonly

No scopes found

64 actions

ActionDescriptionRequired scopes

List Unified Files`googledrive_unified_list_files`

List unified files in Google Drive with StackOne unified filters

`https://​www.googleapis.com/auth/drive.metadata.readonly`

Get Unified File`googledrive_unified_get_file`

Get a unified file by ID with metadata mapped to StackOne unified schema

`https://​www.googleapis.com/auth/drive.metadata.readonly`

Download Unified File`googledrive_unified_download_file`

Downloads unified file content from Google Drive

`https://​www.googleapis.com/auth/drive.readonly`

Upload Unified File`googledrive_unified_upload_file`

Upload a new file to Google Drive using the StackOne unified upload schema

`https://​www.googleapis.com/auth/drive.file`

List Unified Folders`googledrive_unified_list_folders`

List unified folders in Google Drive with StackOne unified filters

`https://​www.googleapis.com/auth/drive.metadata.readonly`

Get Unified Folder`googledrive_unified_get_folder`

Get a unified folder by ID with metadata mapped to StackOne unified schema

`https://​www.googleapis.com/auth/drive.metadata.readonly`

List Unified Drives`googledrive_unified_list_drives`

List unified shared drives in Google Drive

`https://​www.googleapis.com/auth/drive.readonly`

Get Unified Drive`googledrive_unified_get_drive`

Get a unified shared drive by ID with metadata mapped to StackOne unified schema

`https://​www.googleapis.com/auth/drive.readonly`

List Files`googledrive_list_files`

List files, folders, and other Drive items. Returns raw Google Drive API response

`https://​www.googleapis.com/auth/drive.metadata.readonly`

Get File`googledrive_get_file`

Get file, folder, or Drive item by ID

`https://​www.googleapis.com/auth/drive.metadata.readonly`

Copy File`googledrive_copy_file`

Creates a copy of a file and applies any requested updates with patch semantics

`https://​www.googleapis.com/auth/drive.file`

Create File`googledrive_create_file`

Creates a new file or folder with metadata only

`https://​www.googleapis.com/auth/drive.file`

Delete File`googledrive_delete_file`

Permanently deletes a file without moving it to the trash

`https://​www.googleapis.com/auth/drive.file`

Empty Trash`googledrive_empty_trash`

Permanently deletes all of the user's trashed files

`https://​www.googleapis.com/auth/drive`

Generate IDs`googledrive_generate_ids`

Generates a set of file IDs which can be provided in create or copy requests

`https://​www.googleapis.com/auth/drive.file`

Update File`googledrive_update_file`

Updates a file's metadata using patch semantics

`https://​www.googleapis.com/auth/drive.file`

Upload File (Simple)`googledrive_upload_file_simple`

Upload raw file binary content to Google Drive using simple media upload (uploadType=media). Sends only the file bytes —...

`https://​www.googleapis.com/auth/drive.file`

Upload File (Multipart)`googledrive_upload_file_multipart`

Upload a file with both binary content and metadata in a single request using multipart upload (uploadType=multipart). R...

`https://​www.googleapis.com/auth/drive.file`

Upload File (Resumable)`googledrive_upload_file_resumable`

Upload a file to Google Drive using resumable upload (uploadType=resumable). The Google Drive API itself supports files...

`https://​www.googleapis.com/auth/drive.file`

List Shared Drives`googledrive_list_drives`

Lists the user's shared drives (formerly Team Drives)

`https://​www.googleapis.com/auth/drive.readonly`

Get Shared Drive`googledrive_get_drive`

Gets a shared drive's metadata by ID

`https://​www.googleapis.com/auth/drive.readonly`

Create Shared Drive`googledrive_create_drive`

Creates a new shared drive

`https://​www.googleapis.com/auth/drive`

Update Shared Drive`googledrive_update_drive`

Updates the metadata for a shared drive

`https://​www.googleapis.com/auth/drive`

Delete Shared Drive`googledrive_delete_drive`

Permanently deletes a shared drive for which the user is an organizer

`https://​www.googleapis.com/auth/drive`

Hide Shared Drive`googledrive_hide_drive`

Hides a shared drive from the default view

`https://​www.googleapis.com/auth/drive`

Unhide Shared Drive`googledrive_unhide_drive`

Restores a shared drive to the default view

`https://​www.googleapis.com/auth/drive`

List Permissions`googledrive_list_permissions`

Lists a file's or shared drive's permissions

`https://​www.googleapis.com/auth/drive.metadata.readonly`

Get Permission`googledrive_get_permission`

Gets a permission by ID

`https://​www.googleapis.com/auth/drive.metadata.readonly`

Create Permission`googledrive_create_permission`

Creates a new permission for a file or shared drive

`https://​www.googleapis.com/auth/drive.file`

Update Permission`googledrive_update_permission`

Updates a permission with patch semantics (modify role, expiration time, etc.)

`https://​www.googleapis.com/auth/drive.file`

Delete Permission`googledrive_delete_permission`

Deletes a permission (revokes access)

`https://​www.googleapis.com/auth/drive.file`

Check Permissions`googledrive_unified_check_permissions`

Check what permissions a user has on a Google Drive file, folder, or shared drive, and whether a specific action is allo...

`https://​www.googleapis.com/auth/drive.metadata.readonly`

List Comments`googledrive_list_comments`

Lists a file's comments

`https://​www.googleapis.com/auth/drive.readonly`

Get Comment`googledrive_get_comment`

Gets a comment by ID

`https://​www.googleapis.com/auth/drive.readonly`

Create Comment`googledrive_create_comment`

Creates a new comment on a file

`https://​www.googleapis.com/auth/drive.file`

Update Comment`googledrive_update_comment`

Updates a comment. Edits content and/or resolves/reopens it. NOTE — Google Drive's comments.update requires `content` to...

`https://​www.googleapis.com/auth/drive.file`

Delete Comment`googledrive_delete_comment`

Deletes a comment

`https://​www.googleapis.com/auth/drive.file`

List Replies`googledrive_list_replies`

Lists a comment's replies

`https://​www.googleapis.com/auth/drive.readonly`

Get Reply`googledrive_get_reply`

Gets a reply by ID

`https://​www.googleapis.com/auth/drive.readonly`

Create Reply`googledrive_create_reply`

Creates a reply to a comment

`https://​www.googleapis.com/auth/drive.file`

Update Reply`googledrive_update_reply`

Updates a reply with patch semantics

`https://​www.googleapis.com/auth/drive.file`

Delete Reply`googledrive_delete_reply`

Deletes a reply

`https://​www.googleapis.com/auth/drive.file`

List Revisions`googledrive_list_revisions`

Lists a file's revisions

`https://​www.googleapis.com/auth/drive.metadata.readonly`

Get Revision`googledrive_get_revision`

Gets a revision's metadata or content by ID

`https://​www.googleapis.com/auth/drive.metadata.readonly`

Update Revision`googledrive_update_revision`

Updates a revision with patch semantics

`https://​www.googleapis.com/auth/drive.file`

Delete Revision`googledrive_delete_revision`

Permanently deletes a file version

`https://​www.googleapis.com/auth/drive.file`

Get Changes Start Page Token`googledrive_get_changes_start_page_token`

Returns a baseline pageToken representing the current state of Drive. Pass this token as `pageToken` to `list_changes` l...

`https://​www.googleapis.com/auth/drive.metadata.readonly`

List Changes`googledrive_list_changes`

Returns a paginated list of changes.

`https://​www.googleapis.com/auth/drive.metadata.readonly`

List Access Proposals`googledrive_list_access_proposals`

Returns a paginated list of access proposals.

`https://​www.googleapis.com/auth/drive.metadata.readonly`

Get Access Proposal`googledrive_get_access_proposal`

Retrieves an access proposal by ID

`https://​www.googleapis.com/auth/drive.metadata.readonly`

Resolve Access Proposal`googledrive_resolve_access_proposal`

Approves or denies an access proposal

`https://​www.googleapis.com/auth/drive.file`

Get About`googledrive_get_about`

Gets information about the user, the user's Drive, and system capabilities

`https://​www.googleapis.com/auth/drive.metadata.readonly`

Get Unified Credentials`googledrive_unified_get_me`

Get the current Google Drive connection's unified credentials and identity.

`https://​www.googleapis.com/auth/drive.metadata.readonly`

IAM Auth Test`googledrive_auth_test`

Debugging helper that validates the current OAuth access token by calling Google's token introspection endpoint (GET htt...

List Unified Groups`googledrive_unified_list_groups`

List unified groups in Google Drive.

`https://​www.googleapis.com/auth/admin.directory.group.readonly`

Get Unified Group`googledrive_unified_get_group`

Get a unified Google Drive group by ID.

`https://​www.googleapis.com/auth/admin.directory.group.readonly`

List Unified Organizations`googledrive_unified_list_organizations`

List unified organizations in Google Drive.

`https://​www.googleapis.com/auth/admin.directory.domain.readonly`

Get Unified Organization`googledrive_unified_get_organization`

Get a unified Google Drive organization by ID.

`https://​www.googleapis.com/auth/admin.directory.domain.readonly`

List Unified Resource Types`googledrive_unified_list_resource_types`

List unified resource types in Google Drive.

`https://​www.googleapis.com/auth/drive.metadata.readonly`

List Unified Resource Users`googledrive_unified_list_resource_users`

List unified resource users in Google Drive.

`https://​www.googleapis.com/auth/drive.metadata.readonly`

List Unified Roles`googledrive_unified_list_roles`

List unified roles in Google Drive.

`https://​www.googleapis.com/auth/drive.metadata.readonly`

Get Unified Role`googledrive_unified_get_role`

Get a unified Google Drive role by ID.

`https://​www.googleapis.com/auth/drive.metadata.readonly`

List Unified Users`googledrive_unified_list_users`

List unified users in Google Drive.

`https://​www.googleapis.com/auth/admin.directory.user.readonly`

Get Unified User`googledrive_unified_get_user`

Get a unified Google Drive user by ID.

`https://​www.googleapis.com/auth/admin.directory.user.readonly`

## Events

Tags

Select all
|
Clear

Changes

Channels

Webhooks

No tags found

2 events

EventDescriptionTags

Channel Sync Event`googledrive_webhook_sync`

Processes the initial sync notification sent by Google Drive when a watch channel is successfully created on /changes/wa...

ChannelsWebhooks

Change Event`googledrive_webhook_change`

Processes Google Drive change notifications delivered via a /changes/watch channel. Drive notifications carry no payload...

ChangesWebhooks


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.