Google Drive
Manage files, folders, and permissions
Integrate Google Drive into the workflow. Can create, upload, download, copy, move, delete, share files and manage permissions.
| Parameter | Type | Required | Description |
|---|
folderSelector | string | No | No description |
folderId | string | No | No description |
query | string | No | Search term to filter files by name (e.g. "budget" finds files with "budget" in the name). Do NOT use Google Drive query syntax here - just provide a plain search term. |
pageSize | number | No | No description |
pageToken | string | No | No description |
| Parameter | Type | Description |
|---|
files | array | Array of file metadata objects from Google Drive |
↳ id | string | Google Drive file ID |
↳ kind | string | Resource type identifier |
↳ name | string | File name |
↳ mimeType | string | MIME type |
↳ description | string | File description |
↳ originalFilename | string | Original uploaded filename |
↳ fullFileExtension | string | Full file extension |
↳ fileExtension | string | File extension |
↳ owners | json | List of file owners |
↳ permissions | json | File permissions |
↳ permissionIds | json | Permission IDs |
↳ shared | boolean | Whether file is shared |
↳ ownedByMe | boolean | Whether owned by current user |
↳ writersCanShare | boolean | Whether writers can share |
↳ viewersCanCopyContent | boolean | Whether viewers can copy |
↳ copyRequiresWriterPermission | boolean | Whether copy requires writer permission |
↳ sharingUser | json | User who shared the file |
↳ starred | boolean | Whether file is starred |
↳ trashed | boolean | Whether file is in trash |
↳ explicitlyTrashed | boolean | Whether explicitly trashed |
↳ appProperties | json | App-specific properties |
↳ createdTime | string | File creation time |
↳ modifiedTime | string | Last modification time |
↳ modifiedByMeTime | string | When modified by current user |
↳ viewedByMeTime | string | When last viewed by current user |
↳ sharedWithMeTime | string | When shared with current user |
↳ lastModifyingUser | json | User who last modified the file |
↳ viewedByMe | boolean | Whether viewed by current user |
↳ modifiedByMe | boolean | Whether modified by current user |
↳ webViewLink | string | URL to view in browser |
↳ webContentLink | string | Direct download URL |
↳ iconLink | string | URL to file icon |
↳ thumbnailLink | string | URL to thumbnail |
↳ exportLinks | json | Export format links |
↳ size | string | File size in bytes |
↳ quotaBytesUsed | string | Storage quota used |
↳ md5Checksum | string | MD5 hash |
↳ sha1Checksum | string | SHA-1 hash |
↳ sha256Checksum | string | SHA-256 hash |
↳ parents | json | Parent folder IDs |
↳ spaces | json | Spaces containing file |
↳ driveId | string | Shared drive ID |
↳ capabilities | json | User capabilities on file |
↳ version | string | Version number |
↳ headRevisionId | string | Head revision ID |
↳ hasThumbnail | boolean | Whether has thumbnail |
↳ thumbnailVersion | string | Thumbnail version |
↳ imageMediaMetadata | json | Image-specific metadata |
↳ videoMediaMetadata | json | Video-specific metadata |
↳ isAppAuthorized | boolean | Whether created by requesting app |
↳ contentRestrictions | json | Content restrictions |
↳ linkShareMetadata | json | Link share metadata |
nextPageToken | string | Token for fetching the next page of results |
| Parameter | Type | Required | Description |
|---|
fileId | string | Yes | No description |
| Parameter | Type | Description |
|---|
file | json | The file metadata |
↳ id | string | Google Drive file ID |
↳ kind | string | Resource type identifier |
↳ name | string | File name |
↳ mimeType | string | MIME type |
↳ description | string | File description |
↳ size | string | File size in bytes |
↳ starred | boolean | Whether file is starred |
↳ trashed | boolean | Whether file is in trash |
↳ webViewLink | string | URL to view in browser |
↳ webContentLink | string | Direct download URL |
↳ iconLink | string | URL to file icon |
↳ thumbnailLink | string | URL to thumbnail |
↳ parents | json | Parent folder IDs |
↳ owners | json | List of file owners |
↳ permissions | json | File permissions |
↳ createdTime | string | File creation time |
↳ modifiedTime | string | Last modification time |
↳ lastModifyingUser | json | User who last modified the file |
↳ shared | boolean | Whether file is shared |
↳ ownedByMe | boolean | Whether owned by current user |
↳ capabilities | json | User capabilities on file |
↳ md5Checksum | string | MD5 hash |
↳ version | string | Version number |
| Parameter | Type | Required | Description |
|---|
fileName | string | Yes | No description |
folderSelector | string | No | No description |
folderId | string | No | No description |
| Parameter | Type | Description |
|---|
file | object | Complete created folder metadata from Google Drive |
↳ id | string | Google Drive folder ID |
↳ kind | string | Resource type identifier |
↳ name | string | Folder name |
↳ mimeType | string | MIME type (application/vnd.google-apps.folder) |
↳ description | string | Folder description |
↳ owners | json | List of folder owners |
↳ permissions | json | Folder permissions |
↳ permissionIds | json | Permission IDs |
↳ shared | boolean | Whether folder is shared |
↳ ownedByMe | boolean | Whether owned by current user |
↳ writersCanShare | boolean | Whether writers can share |
↳ viewersCanCopyContent | boolean | Whether viewers can copy |
↳ copyRequiresWriterPermission | boolean | Whether copy requires writer permission |
↳ sharingUser | json | User who shared the folder |
↳ starred | boolean | Whether folder is starred |
↳ trashed | boolean | Whether folder is in trash |
↳ explicitlyTrashed | boolean | Whether explicitly trashed |
↳ appProperties | json | App-specific properties |
↳ folderColorRgb | string | Folder color |
↳ createdTime | string | Folder creation time |
↳ modifiedTime | string | Last modification time |
↳ modifiedByMeTime | string | When modified by current user |
↳ viewedByMeTime | string | When last viewed by current user |
↳ sharedWithMeTime | string | When shared with current user |
↳ lastModifyingUser | json | User who last modified the folder |
↳ viewedByMe | boolean | Whether viewed by current user |
↳ modifiedByMe | boolean | Whether modified by current user |
↳ webViewLink | string | URL to view in browser |
↳ iconLink | string | URL to folder icon |
↳ parents | json | Parent folder IDs |
↳ spaces | json | Spaces containing folder |
↳ driveId | string | Shared drive ID |
↳ capabilities | json | User capabilities on folder |
↳ version | string | Version number |
↳ isAppAuthorized | boolean | Whether created by requesting app |
↳ contentRestrictions | json | Content restrictions |
↳ linkShareMetadata | json | Link share metadata |
| Parameter | Type | Required | Description |
|---|
fileName | string | Yes | No description |
file | file | No | No description |
content | string | No | No description |
mimeType | string | No | No description |
folderSelector | string | No | No description |
folderId | string | No | No description |
| Parameter | Type | Description |
|---|
file | object | Complete uploaded file metadata from Google Drive |
↳ id | string | Google Drive file ID |
↳ kind | string | Resource type identifier |
↳ name | string | File name |
↳ mimeType | string | MIME type |
↳ description | string | File description |
↳ originalFilename | string | Original uploaded filename |
↳ fullFileExtension | string | Full file extension |
↳ fileExtension | string | File extension |
↳ owners | json | List of file owners |
↳ permissions | json | File permissions |
↳ permissionIds | json | Permission IDs |
↳ shared | boolean | Whether file is shared |
↳ ownedByMe | boolean | Whether owned by current user |
↳ writersCanShare | boolean | Whether writers can share |
↳ viewersCanCopyContent | boolean | Whether viewers can copy |
↳ copyRequiresWriterPermission | boolean | Whether copy requires writer permission |
↳ sharingUser | json | User who shared the file |
↳ starred | boolean | Whether file is starred |
↳ trashed | boolean | Whether file is in trash |
↳ explicitlyTrashed | boolean | Whether explicitly trashed |
↳ appProperties | json | App-specific properties |
↳ createdTime | string | File creation time |
↳ modifiedTime | string | Last modification time |
↳ modifiedByMeTime | string | When modified by current user |
↳ viewedByMeTime | string | When last viewed by current user |
↳ sharedWithMeTime | string | When shared with current user |
↳ lastModifyingUser | json | User who last modified the file |
↳ viewedByMe | boolean | Whether viewed by current user |
↳ modifiedByMe | boolean | Whether modified by current user |
↳ webViewLink | string | URL to view in browser |
↳ webContentLink | string | Direct download URL |
↳ iconLink | string | URL to file icon |
↳ thumbnailLink | string | URL to thumbnail |
↳ exportLinks | json | Export format links |
↳ size | string | File size in bytes |
↳ quotaBytesUsed | string | Storage quota used |
↳ md5Checksum | string | MD5 hash |
↳ sha1Checksum | string | SHA-1 hash |
↳ sha256Checksum | string | SHA-256 hash |
↳ parents | json | Parent folder IDs |
↳ spaces | json | Spaces containing file |
↳ driveId | string | Shared drive ID |
↳ capabilities | json | User capabilities on file |
↳ version | string | Version number |
↳ headRevisionId | string | Head revision ID |
↳ hasThumbnail | boolean | Whether has thumbnail |
↳ thumbnailVersion | string | Thumbnail version |
↳ imageMediaMetadata | json | Image-specific metadata |
↳ videoMediaMetadata | json | Video-specific metadata |
↳ isAppAuthorized | boolean | Whether created by requesting app |
↳ contentRestrictions | json | Content restrictions |
↳ linkShareMetadata | json | Link share metadata |
Download a file from Google Drive with complete metadata (exports Google Workspace files automatically)
| Parameter | Type | Required | Description |
|---|
fileId | string | Yes | No description |
mimeType | string | No | No description |
fileName | string | No | No description |
includeRevisions | boolean | No | Whether to include revision history in the metadata (default: true, returns first 100 revisions) |
| Parameter | Type | Description |
|---|
file | file | Downloaded file stored in execution files |
metadata | object | Complete file metadata from Google Drive |
↳ id | string | Google Drive file ID |
↳ kind | string | Resource type identifier |
↳ name | string | File name |
↳ mimeType | string | MIME type |
↳ description | string | File description |
↳ originalFilename | string | Original uploaded filename |
↳ fullFileExtension | string | Full file extension |
↳ fileExtension | string | File extension |
↳ owners | json | List of file owners |
↳ permissions | json | File permissions |
↳ permissionIds | json | Permission IDs |
↳ shared | boolean | Whether file is shared |
↳ ownedByMe | boolean | Whether owned by current user |
↳ writersCanShare | boolean | Whether writers can share |
↳ viewersCanCopyContent | boolean | Whether viewers can copy |
↳ copyRequiresWriterPermission | boolean | Whether copy requires writer permission |
↳ sharingUser | json | User who shared the file |
↳ starred | boolean | Whether file is starred |
↳ trashed | boolean | Whether file is in trash |
↳ explicitlyTrashed | boolean | Whether explicitly trashed |
↳ appProperties | json | App-specific properties |
↳ createdTime | string | File creation time |
↳ modifiedTime | string | Last modification time |
↳ modifiedByMeTime | string | When modified by current user |
↳ viewedByMeTime | string | When last viewed by current user |
↳ sharedWithMeTime | string | When shared with current user |
↳ lastModifyingUser | json | User who last modified the file |
↳ viewedByMe | boolean | Whether viewed by current user |
↳ modifiedByMe | boolean | Whether modified by current user |
↳ webViewLink | string | URL to view in browser |
↳ webContentLink | string | Direct download URL |
↳ iconLink | string | URL to file icon |
↳ thumbnailLink | string | URL to thumbnail |
↳ exportLinks | json | Export format links |
↳ size | string | File size in bytes |
↳ quotaBytesUsed | string | Storage quota used |
↳ md5Checksum | string | MD5 hash |
↳ sha1Checksum | string | SHA-1 hash |
↳ sha256Checksum | string | SHA-256 hash |
↳ parents | json | Parent folder IDs |
↳ spaces | json | Spaces containing file |
↳ driveId | string | Shared drive ID |
↳ capabilities | json | User capabilities on file |
↳ version | string | Version number |
↳ headRevisionId | string | Head revision ID |
↳ hasThumbnail | boolean | Whether has thumbnail |
↳ thumbnailVersion | string | Thumbnail version |
↳ imageMediaMetadata | json | Image-specific metadata |
↳ videoMediaMetadata | json | Video-specific metadata |
↳ isAppAuthorized | boolean | Whether created by requesting app |
↳ contentRestrictions | json | Content restrictions |
↳ linkShareMetadata | json | Link share metadata |
↳ revisions | json | File revision history (first 100 revisions only) |
| Parameter | Type | Required | Description |
|---|
fileId | string | Yes | No description |
newName | string | No | Name for the copied file (defaults to "Copy of [original name]") |
destinationFolderId | string | No | No description |
| Parameter | Type | Description |
|---|
file | json | The copied file metadata |
↳ id | string | Google Drive file ID of the copy |
↳ kind | string | Resource type identifier |
↳ name | string | File name |
↳ mimeType | string | MIME type |
↳ webViewLink | string | URL to view in browser |
↳ parents | json | Parent folder IDs |
↳ createdTime | string | File creation time |
↳ modifiedTime | string | Last modification time |
↳ owners | json | List of file owners |
↳ size | string | File size in bytes |
| Parameter | Type | Required | Description |
|---|
fileId | string | Yes | No description |
name | string | No | No description |
description | string | No | No description |
addParents | string | No | No description |
removeParents | string | No | No description |
starred | boolean | No | No description |
| Parameter | Type | Description |
|---|
file | json | The updated file metadata |
↳ id | string | Google Drive file ID |
↳ kind | string | Resource type identifier |
↳ name | string | File name |
↳ mimeType | string | MIME type |
↳ description | string | File description |
↳ starred | boolean | Whether file is starred |
↳ webViewLink | string | URL to view in browser |
↳ parents | json | Parent folder IDs |
↳ modifiedTime | string | Last modification time |
| Parameter | Type | Required | Description |
|---|
fileId | string | Yes | No description |
| Parameter | Type | Description |
|---|
file | json | The trashed file metadata |
↳ id | string | Google Drive file ID |
↳ kind | string | Resource type identifier |
↳ name | string | File name |
↳ mimeType | string | MIME type |
↳ trashed | boolean | Whether file is in trash (should be true) |
↳ trashedTime | string | When file was trashed |
↳ webViewLink | string | URL to view in browser |
| Parameter | Type | Required | Description |
|---|
fileId | string | Yes | No description |
| Parameter | Type | Description |
|---|
deleted | boolean | Whether the file was successfully deleted |
fileId | string | The ID of the deleted file |
| Parameter | Type | Required | Description |
|---|
fileId | string | Yes | No description |
type | string | Yes | No description |
role | string | Yes | Permission role: owner (transfer ownership), organizer (shared drive only), fileOrganizer (shared drive only), writer (edit), commenter (view and comment), reader (view only) |
email | string | No | No description |
domain | string | No | No description |
transferOwnership | boolean | No | No description |
moveToNewOwnersRoot | boolean | No | When transferring ownership, move the file to the new owner's My Drive root folder. |
sendNotification | boolean | No | No description |
emailMessage | string | No | No description |
| Parameter | Type | Description |
|---|
permission | json | The created permission details |
↳ id | string | Permission ID |
↳ type | string | Grantee type (user, group, domain, anyone) |
↳ role | string | Permission role |
↳ emailAddress | string | Email of the grantee |
↳ displayName | string | Display name of the grantee |
↳ domain | string | Domain of the grantee |
↳ expirationTime | string | Expiration time |
↳ deleted | boolean | Whether grantee is deleted |
| Parameter | Type | Required | Description |
|---|
fileId | string | Yes | No description |
permissionId | string | Yes | No description |
| Parameter | Type | Description |
|---|
removed | boolean | Whether the permission was successfully removed |
fileId | string | The ID of the file |
permissionId | string | The ID of the removed permission |
| Parameter | Type | Required | Description |
|---|
fileId | string | Yes | No description |
| Parameter | Type | Description |
|---|
permissions | array | List of permissions on the file |
↳ id | string | Permission ID (use to remove permission) |
↳ type | string | Grantee type (user, group, domain, anyone) |
↳ role | string | Permission role (owner, organizer, fileOrganizer, writer, commenter, reader) |
↳ emailAddress | string | Email of the grantee |
↳ displayName | string | Display name of the grantee |
↳ photoLink | string | Photo URL of the grantee |
↳ domain | string | Domain of the grantee |
↳ expirationTime | string | When permission expires |
↳ deleted | boolean | Whether grantee account is deleted |
↳ allowFileDiscovery | boolean | Whether file is discoverable by grantee |
↳ pendingOwner | boolean | Whether ownership transfer is pending |
↳ permissionDetails | json | Details about inherited permissions |
nextPageToken | string | Token for fetching the next page of permissions |
Get information about the user and their Google Drive (storage quota, capabilities)
| Parameter | Type | Required | Description |
|---|
| Parameter | Type | Description |
|---|
user | json | Information about the authenticated user |
↳ displayName | string | User display name |
↳ emailAddress | string | User email address |
↳ photoLink | string | URL to user profile photo |
↳ permissionId | string | User permission ID |
↳ me | boolean | Whether this is the authenticated user |
storageQuota | json | Storage quota information in bytes |
↳ limit | string | Total storage limit in bytes (null for unlimited) |
↳ usage | string | Total storage used in bytes |
↳ usageInDrive | string | Storage used by Drive files in bytes |
↳ usageInDriveTrash | string | Storage used by trashed files in bytes |
canCreateDrives | boolean | Whether user can create shared drives |
importFormats | json | Map of MIME types that can be imported and their target formats |
exportFormats | json | Map of Google Workspace MIME types and their exportable formats |
maxUploadSize | string | Maximum upload size in bytes |
Get content from a file in Google Drive with complete metadata (exports Google Workspace files automatically)
| Parameter | Type | Required | Description |
|---|
fileId | string | Yes | No description |
mimeType | string | No | No description |
includeRevisions | boolean | No | Whether to include revision history in the metadata (default: true, returns first 100 revisions) |
| Parameter | Type | Description |
|---|
content | string | File content as text (Google Workspace files are exported) |
metadata | object | Complete file metadata from Google Drive |
↳ id | string | Google Drive file ID |
↳ kind | string | Resource type identifier |
↳ name | string | File name |
↳ mimeType | string | MIME type |
↳ description | string | File description |
↳ originalFilename | string | Original uploaded filename |
↳ fullFileExtension | string | Full file extension |
↳ fileExtension | string | File extension |
↳ owners | json | List of file owners |
↳ permissions | json | File permissions |
↳ permissionIds | json | Permission IDs |
↳ shared | boolean | Whether file is shared |
↳ ownedByMe | boolean | Whether owned by current user |
↳ writersCanShare | boolean | Whether writers can share |
↳ viewersCanCopyContent | boolean | Whether viewers can copy |
↳ copyRequiresWriterPermission | boolean | Whether copy requires writer permission |
↳ sharingUser | json | User who shared the file |
↳ starred | boolean | Whether file is starred |
↳ trashed | boolean | Whether file is in trash |
↳ explicitlyTrashed | boolean | Whether explicitly trashed |
↳ appProperties | json | App-specific properties |
↳ createdTime | string | File creation time |
↳ modifiedTime | string | Last modification time |
↳ modifiedByMeTime | string | When modified by current user |
↳ viewedByMeTime | string | When last viewed by current user |
↳ sharedWithMeTime | string | When shared with current user |
↳ lastModifyingUser | json | User who last modified the file |
↳ viewedByMe | boolean | Whether viewed by current user |
↳ modifiedByMe | boolean | Whether modified by current user |
↳ webViewLink | string | URL to view in browser |
↳ webContentLink | string | Direct download URL |
↳ iconLink | string | URL to file icon |
↳ thumbnailLink | string | URL to thumbnail |
↳ exportLinks | json | Export format links |
↳ size | string | File size in bytes |
↳ quotaBytesUsed | string | Storage quota used |
↳ md5Checksum | string | MD5 hash |
↳ sha1Checksum | string | SHA-1 hash |
↳ sha256Checksum | string | SHA-256 hash |
↳ parents | json | Parent folder IDs |
↳ spaces | json | Spaces containing file |
↳ driveId | string | Shared drive ID |
↳ capabilities | json | User capabilities on file |
↳ version | string | Version number |
↳ headRevisionId | string | Head revision ID |
↳ hasThumbnail | boolean | Whether has thumbnail |
↳ thumbnailVersion | string | Thumbnail version |
↳ imageMediaMetadata | json | Image-specific metadata |
↳ videoMediaMetadata | json | Video-specific metadata |
↳ isAppAuthorized | boolean | Whether created by requesting app |
↳ contentRestrictions | json | Content restrictions |
↳ linkShareMetadata | json | Link share metadata |
↳ revisions | json | File revision history (first 100 revisions only) |
| Parameter | Type | Required | Description |
|---|
fileId | string | Yes | No description |
destinationFolderId | string | Yes | No description |
removeFromCurrent | boolean | No | Whether to remove the file from its current parent folder (default: true). Set to false to add the file to the destination without removing it from the current location. |
| Parameter | Type | Description |
|---|
file | json | The moved file metadata |
↳ id | string | Google Drive file ID |
↳ kind | string | Resource type identifier |
↳ name | string | File name |
↳ mimeType | string | MIME type |
↳ webViewLink | string | URL to view in browser |
↳ parents | json | Parent folder IDs |
↳ createdTime | string | File creation time |
↳ modifiedTime | string | Last modification time |
↳ owners | json | List of file owners |
↳ size | string | File size in bytes |
Search for files in Google Drive using advanced query syntax (e.g., fullText contains, mimeType, modifiedTime, etc.)
| Parameter | Type | Required | Description |
|---|
query | string | Yes | Google Drive query string using advanced search syntax (e.g., "fullText contains 'budget'", "mimeType = 'application/pdf'", "modifiedTime > '2024-01-01'") |
pageSize | number | No | No description |
pageToken | string | No | No description |
| Parameter | Type | Description |
|---|
files | array | Array of file metadata objects matching the search query |
↳ id | string | Google Drive file ID |
↳ kind | string | Resource type identifier |
↳ name | string | File name |
↳ mimeType | string | MIME type |
↳ description | string | File description |
↳ originalFilename | string | Original uploaded filename |
↳ fullFileExtension | string | Full file extension |
↳ fileExtension | string | File extension |
↳ owners | json | List of file owners |
↳ permissions | json | File permissions |
↳ shared | boolean | Whether file is shared |
↳ ownedByMe | boolean | Whether owned by current user |
↳ starred | boolean | Whether file is starred |
↳ trashed | boolean | Whether file is in trash |
↳ createdTime | string | File creation time |
↳ modifiedTime | string | Last modification time |
↳ lastModifyingUser | json | User who last modified the file |
↳ webViewLink | string | URL to view in browser |
↳ webContentLink | string | Direct download URL |
↳ iconLink | string | URL to file icon |
↳ thumbnailLink | string | URL to thumbnail |
↳ size | string | File size in bytes |
↳ parents | json | Parent folder IDs |
↳ driveId | string | Shared drive ID |
↳ capabilities | json | User capabilities on file |
↳ version | string | Version number |
nextPageToken | string | Token for fetching the next page of results |
| Parameter | Type | Required | Description |
|---|
fileId | string | Yes | No description |
| Parameter | Type | Description |
|---|
file | json | The restored file metadata |
↳ id | string | Google Drive file ID |
↳ kind | string | Resource type identifier |
↳ name | string | File name |
↳ mimeType | string | MIME type |
↳ trashed | boolean | Whether file is in trash (should be false) |
↳ webViewLink | string | URL to view in browser |
↳ parents | json | Parent folder IDs |
