Google Drive

googledrive

Google Drive is a cloud storage solution for uploading, sharing, and collaborating on files across devices, with robust search and offline access

File Management & Storage Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Sí

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (51)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Add file sharing preferenceGOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCEAcción

Modifies sharing permissions for an existing google drive file, granting a specified role to a user, group, domain, or 'anyone'.

Parámetros de entrada

rolestringObligatorio
Permission role to grant.
typestringObligatorio
Type of grantee for the permission.
domainstring
Domain to grant permission to (e.g., 'example.com'). Required if 'type' is 'domain'.
file_idstringObligatorio
Unique identifier of the file to update sharing settings for.
email_addressstring
Email address of the user or group. Required if 'type' is 'user' or 'group'.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Copy fileGOOGLEDRIVE_COPY_FILEAcción

Duplicates an existing file in google drive, identified by its `file id`.

Parámetros de entrada

file_idstringObligatorio
The unique identifier for the file on Google Drive that you want to copy. This ID can be retrieved from the file's shareable link or via other Google Drive API calls.
new_titlestring
The title to assign to the new copy of the file. If not provided, the copied file will have the same title as the original, prefixed with 'Copy of '.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create CommentGOOGLEDRIVE_CREATE_COMMENTAcción

Tool to create a comment on a file. use when you need to add a new comment to a specific file in google drive.

Parámetros de entrada

anchorstring
A JSON string representing the region of the document to which the comment is anchored (e.g., {'type': 'line', 'line': 12}).
contentstringObligatorio
The plain text content of the comment.
file_idstringObligatorio
The ID of the file.
quoted_file_content_valuestring
The quoted content itself.
quoted_file_content_mime_typestring
The MIME type of the quoted content.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Shared DriveGOOGLEDRIVE_CREATE_DRIVEAcción

Tool to create a new shared drive. use when you need to programmatically create a new shared drive for collaboration or storage.

Parámetros de entrada

namestringObligatorio
The name of this shared drive.
hiddenboolean
Whether the shared drive is hidden from default view.
themeIdstring
The ID of the theme from which the background image and color will be set. The set of possible driveThemes can be retrieved from a drive.about.get response. When not specified on a drive.drives.create request, a random theme is chosen from which the background image and color are set. This is a write-only field; it can only be set on requests that don't set colorRgb or backgroundImageFile.
colorRgbstring
The color of this shared drive as an RGB hex string. It can only be set on a drive.drives.update request that does not set themeId.
requestIdstringObligatorio
An ID, such as a random UUID, which uniquely identifies this user's request for idempotent creation of a shared drive. A repeated request by the same user and with the same request ID will avoid creating duplicates by attempting to create the same shared drive. If the shared drive already exists a 409 error will be returned.
backgroundImageFileobject
An image file and cropping parameters from which a background image for this shared drive is set. This is a write only field; it can only be set on drive.drives.update requests that don't set themeId. When specified, all fields of the backgroundImageFile must be set.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create File or FolderGOOGLEDRIVE_CREATE_FILEAcción

Creates a new file or folder with metadata. use to create empty files or folders, or files with content by providing it in the request body (though this action primarily focuses on metadata creation).

Parámetros de entrada

namestring
The name of the file.
fieldsstring
A comma-separated list of fields to include in the response.
parentsstring[]
The IDs of parent folders.
starredboolean
Whether the user has starred the file.
mimeTypestring
The MIME type of the file.
descriptionstring
A short description of the file.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create a File from TextGOOGLEDRIVE_CREATE_FILE_FROM_TEXTAcción

Creates a new file in google drive from provided text content (up to 10mb), supporting various formats including automatic conversion to google workspace types.

Parámetros de entrada

file_namestringObligatorio
Desired name for the new file on Google Drive.
mime_typestring
MIME type for the new file, determining how Google Drive interprets its content.
parent_idstring
ID of the parent folder in Google Drive; if omitted, the file is created in the root of 'My Drive'.
text_contentstringObligatorio
Plain text content to be written into the new file.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create a folderGOOGLEDRIVE_CREATE_FOLDERAcción

Creates a new folder in google drive, optionally within a parent folder specified by its id or name; if a parent name is provided but not found, the action will fail.

Parámetros de entrada

parent_idstring
ID or name of the parent folder. If a name is provided, the action attempts to find it. If an ID is provided, it must be a valid Google Drive folder ID. If omitted, the folder is created in the Drive root.
folder_namestringObligatorio
Name for the new folder.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create ReplyGOOGLEDRIVE_CREATE_REPLYAcción

Tool to create a reply to a comment in google drive. use when you need to respond to an existing comment on a file.

Parámetros de entrada

actionstring
The action the reply performed to the parent comment. Valid values are: resolve, reopen.
fieldsstring
Selector specifying which fields to include in a partial response.
contentstringObligatorio
The plain text content of the reply. HTML content is not supported.
file_idstringObligatorio
The ID of the file.
comment_idstringObligatorio
The ID of the comment.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Shortcut to File/FolderGOOGLEDRIVE_CREATE_SHORTCUT_TO_FILEAcción

Tool to create a shortcut to a file or folder in google drive. use when you need to link to an existing drive item from another location without duplicating it.

Parámetros de entrada

namestringObligatorio
The name of the shortcut.
target_idstringObligatorio
The ID of the file or folder that this shortcut points to.
includeLabelsstring
A comma-separated list of IDs of labels to include in the labelInfo part of the response.
target_mime_typestring
The MIME type of the target file or folder. While optional, providing it can be helpful.
supportsAllDrivesboolean
Whether the requesting application supports both My Drives and shared drives. Recommended to set to true if interacting with shared drives.
keepRevisionForeverboolean
Whether to set the 'keepForever' field in the new head revision.
ignoreDefaultVisibilityboolean
Whether to ignore the domain's default visibility settings for the created file.
includePermissionsForViewstring
Specifies which additional view's permissions to include in the response. Only 'published' is supported.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete CommentGOOGLEDRIVE_DELETE_COMMENTAcción

Deletes a comment from a file. use when you need to remove a specific comment from a google drive file.

Parámetros de entrada

file_idstringObligatorio
The ID of the file.
comment_idstringObligatorio
The ID of the comment.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Shared DriveGOOGLEDRIVE_DELETE_DRIVEAcción

Tool to permanently delete a shared drive. use when you need to remove a shared drive and its contents (if specified).

Parámetros de entrada

driveIdstringObligatorio
The ID of the shared drive.
allowItemDeletionboolean
Whether any items inside the shared drive should also be deleted. This option is only supported when `useDomainAdminAccess` is also set to `true`.
useDomainAdminAccessboolean
Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the shared drive belongs.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete PermissionGOOGLEDRIVE_DELETE_PERMISSIONAcción

Deletes a permission from a file by permission id. use when you need to revoke access for a specific user or group from a file.

Parámetros de entrada

file_idstringObligatorio
The ID of the file or shared drive.
permission_idstringObligatorio
The ID of the permission.
supportsAllDrivesboolean
Whether the requesting application supports both My Drives and shared drives.
useDomainAdminAccessboolean
Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete ReplyGOOGLEDRIVE_DELETE_REPLYAcción

Tool to delete a specific reply by reply id. use when you need to remove a reply from a comment on a file.

Parámetros de entrada

file_idstringObligatorio
The ID of the file.
reply_idstringObligatorio
The ID of the reply.
comment_idstringObligatorio
The ID of the comment.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Download a file from Google DriveGOOGLEDRIVE_DOWNLOAD_FILEAcción

Downloads a file from google drive by its id. for google workspace documents (docs, sheets, slides), optionally exports to a specified `mime type`. for other file types, downloads in their native format regardless of mime type.

Parámetros de entrada

file_idstringObligatorio
The unique identifier of the file to be downloaded from Google Drive. This ID can typically be found in the file's URL in Google Drive or obtained from API calls that list files.
mime_typestringenum
Target MIME type for exporting Google Workspace documents (e.g., Google Doc, Sheet, Slide). Supported export formats vary by file type; e.g., text/plain is only supported for Google Docs, not Sheets or Slides. This parameter is automatically ignored for non-Google Workspace files, which are downloaded in their native format. Only specify this when you want to export a Google Workspace document to a different format (e.g., export Google Doc to PDF).
application/vnd.openxmlformats-officedocument.wordprocessingml.documentapplication/vnd.oasis.opendocument.textapplication/rtfapplication/pdftext/plainapplication/zipapplication/epub+ziptext/markdownapplication/vnd.openxmlformats-officedocument.spreadsheetml.sheetapplication/x-vnd.oasis.opendocument.spreadsheettext/csvtext/tab-separated-values+7

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Edit FileGOOGLEDRIVE_EDIT_FILEAcción

Updates an existing google drive file by overwriting its entire content with new text (max 10mb).

Parámetros de entrada

contentstringObligatorio
New textual content to overwrite the existing file; will be UTF-8 encoded for upload.
file_idstringObligatorio
Identifier of the Google Drive file to update.
mime_typestring
MIME type of the 'content' being uploaded; must accurately represent its format.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Empty TrashGOOGLEDRIVE_EMPTY_TRASHAcción

Tool to permanently delete all of the user's trashed files. use when you want to empty the trash in google drive.

Parámetros de entrada

driveIdstring
If set, empties the trash of the provided shared drive. This parameter is ignored if the item is not in a shared drive.
enforceSingleParentboolean
Deprecated: If an item is not in a shared drive and its last parent is deleted but the item itself is not, the item will be placed under its owner's root. This parameter is ignored if the item is not in a shared drive.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Modify File LabelsGOOGLEDRIVE_FILES_MODIFY_LABELSAcción

Modifies the set of labels applied to a file. returns a list of the labels that were added or modified. use when you need to programmatically change labels on a google drive file, such as adding, updating, or removing them.

Parámetros de entrada

kindstring
This is always drive#modifyLabelsRequest.
file_idstringObligatorio
The ID of the file.
label_modificationsobject[]Obligatorio
The list of modifications to apply to the labels on the file.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Find fileGOOGLEDRIVE_FIND_FILEAcción

Tool to list or search for files and folders in google drive. use when you need to find specific files based on query criteria or list contents of a drive/folder.

Parámetros de entrada

qstring
A query for filtering the file results. See Google Drive API documentation for query syntax. Example: \"name contains 'report' and mimeType = 'application/pdf'\"
fieldsstring
Selector specifying which fields to include in a partial response. Use '*' for all fields or a comma-separated list, e.g., 'nextPageToken,files(id,name,mimeType)'.
spacesstring
A comma-separated list of spaces to query. Supported values are 'drive', 'appDataFolder' and 'photos'.
corporastringenum
Corpora to query. 'user' for user's personal files, 'drive' for files in a specific shared drive (requires 'driveId'), 'domain' for files shared with the domain, 'allDrives' for all drives the user has access to.
userdrivedomainallDrives
driveIdstring
ID of the shared drive to search. Required if 'corpora' is 'drive'.
orderBystring
A comma-separated list of sort keys. Valid keys are 'createdTime', 'folder', 'modifiedByMeTime', 'modifiedTime', 'name', 'name_natural', 'quotaBytesUsed', 'recency', 'sharedWithMeTime', 'starred', and 'viewedByMeTime'. Each key sorts ascending by default, but may be reversed with the 'desc' modifier. Example: 'modifiedTime desc,name'.
pageSizeinteger
The maximum number of files to return per page.
pageTokenstring
The token for continuing a previous list request on the next page.
supportsAllDrivesboolean
Whether the requesting application supports both My Drives and shared drives. If 'includeItemsFromAllDrives' is true, this must also be true.
includeItemsFromAllDrivesboolean
Whether both My Drive and shared drive items should be included in results. If true, 'supportsAllDrives' should also be true.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Find folderGOOGLEDRIVE_FIND_FOLDERAcción

Tool to find a folder in google drive by its name and optionally a parent folder. use when you need to locate a specific folder to perform further actions like creating files in it or listing its contents.

Parámetros de entrada

starredboolean
Set to true to search for folders that are starred, or false for those that are not.
name_exactstring
The exact name of the folder to search for. This search is case-sensitive.
name_containsstring
A substring to search for within folder names. This search is case-insensitive.
modified_afterstring
Search for folders modified after a specific date and time. The timestamp must be in RFC 3339 format (e.g., '2023-01-15T10:00:00Z' or '2023-01-15T10:00:00.000Z').
name_not_containsstring
A substring to exclude from folder names. Folders with names containing this substring will not be returned. This search is case-insensitive.
full_text_containsstring
A string to search for within the full text content of files within folders (if applicable and supported by Drive for the folder type or its contents). This search is case-insensitive.
full_text_not_containsstring
A string to exclude from the full text content of files within folders. This search is case-insensitive.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Generate File IDsGOOGLEDRIVE_GENERATE_IDSAcción

Generates a set of file ids which can be provided in create or copy requests. use when you need to pre-allocate ids for new files or copies.

Parámetros de entrada

typestring
The type of items for which the IDs can be used. For example, 'files' or 'shortcuts'.
countinteger
The number of IDs to return. Value must be between 1 and 1000, inclusive.
spacestring
The space in which the IDs can be used. Supported values are 'drive' and 'appDataFolder'.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get aboutGOOGLEDRIVE_GET_ABOUTAcción

Tool to retrieve information about the user, the user's drive, and system capabilities. use when you need to check storage quotas, user details, or supported import/export formats.

Parámetros de entrada

fieldsstring
A comma-separated list of fields to include in the response. Use `*` to include all fields.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Changes Start Page TokenGOOGLEDRIVE_GET_CHANGES_START_PAGE_TOKENAcción

Tool to get the starting pagetoken for listing future changes in google drive. use this when you need to track changes to files and folders.

Parámetros de entrada

driveIdstring
The ID of the shared drive for which the starting pageToken for listing future changes from that shared drive will be returned.
teamDriveIdstring
Deprecated: Use driveId instead.
supportsAllDrivesboolean
Whether the requesting application supports both My Drives and shared drives. Defaults to false.
supportsTeamDrivesboolean
Deprecated: Use supportsAllDrives instead.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get CommentGOOGLEDRIVE_GET_COMMENTAcción

Tool to get a comment by id. use when you need to retrieve a specific comment from a google drive file and have both the file id and comment id.

Parámetros de entrada

fileIdstringObligatorio
The ID of the file.
commentIdstringObligatorio
The ID of the comment.
includeDeletedboolean
Whether to return deleted comments. Deleted comments will not include their original content.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Shared DriveGOOGLEDRIVE_GET_DRIVEAcción

Tool to get a shared drive by id. use when you need to retrieve information about a specific shared drive.

Parámetros de entrada

drive_idstringObligatorio
The ID of the shared drive.
use_domain_admin_accessboolean
Issue the request as a domain administrator; if set to true, then the requester will be granted access if they are an administrator of the domain to which the shared drive belongs.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get File MetadataGOOGLEDRIVE_GET_FILE_METADATAAcción

Tool to get a file's metadata by id. use when you need to retrieve the metadata for a specific file in google drive.

Parámetros de entrada

fileIdstringObligatorio
The ID of the file.
includeLabelsstring
A comma-separated list of IDs of labels to include in the labelInfo part of the response.
acknowledgeAbuseboolean
Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the alt parameter is set to media and the user is the owner of the file or an organizer of the shared drive in which the file resides.
supportsAllDrivesboolean
Whether the requesting application supports both My Drives and shared drives. This parameter will default to false.
includePermissionsForViewstring
Specifies which additional view's permissions to include in the response. Only 'published' is supported.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get PermissionGOOGLEDRIVE_GET_PERMISSIONAcción

Gets a permission by id. use this tool to retrieve a specific permission for a file or shared drive.

Parámetros de entrada

file_idstringObligatorio
The ID of the file.
permission_idstringObligatorio
The ID of the permission.
supports_all_drivesboolean
Whether the requesting application supports both My Drives and shared drives.
use_domain_admin_accessboolean
Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get ReplyGOOGLEDRIVE_GET_REPLYAcción

Tool to get a specific reply to a comment on a file. use when you need to retrieve the details of a particular reply.

Parámetros de entrada

fileIdstringObligatorio
The ID of the file.
replyIdstringObligatorio
The ID of the reply.
commentIdstringObligatorio
The ID of the comment.
includeDeletedboolean
Whether to return deleted replies. Deleted replies will not include their original content.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get RevisionGOOGLEDRIVE_GET_REVISIONAcción

Tool to get a specific revision's metadata by revision id. use when you need to retrieve information about a particular version of a file.

Parámetros de entrada

file_idstringObligatorio
The ID of the file.
revision_idstringObligatorio
The ID of the revision.
acknowledge_abuseboolean
Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the alt parameter is set to media and the user is the owner of the file or an organizer of the shared drive in which the file resides.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete folder or fileGOOGLEDRIVE_GOOGLE_DRIVE_DELETE_FOLDER_OR_FILE_ACTIONAcción

Tool to delete a file or folder in google drive. use when you need to permanently remove a specific file or folder using its id. note: this action is irreversible.

Parámetros de entrada

fileIdstringObligatorio
The ID of the file or folder to delete. This is a required field.
supportsAllDrivesboolean
Whether the application supports both My Drives and shared drives. If false or unspecified, the file is attempted to be deleted from the user's My Drive. If true, the item will be deleted from shared drives as well if necessary.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Hide Shared DriveGOOGLEDRIVE_HIDE_DRIVEAcción

Tool to hide a shared drive from the default view. use when you want to remove a shared drive from the user's main google drive interface without deleting it.

Parámetros de entrada

drive_idstringObligatorio
The ID of the shared drive.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List ChangesGOOGLEDRIVE_LIST_CHANGESAcción

Tool to list the changes for a user or shared drive. use when you need to track modifications to files and folders, such as creations, deletions, or permission changes. this action requires a `pagetoken` which can be initially obtained using the `get changes start page token` action or from a previous `list changes` response.

Parámetros de entrada

spacesstring
A comma-separated list of spaces to query within the corpora. Supported values are 'drive' and 'appDataFolder'.
driveIdstring
The shared drive from which changes will be returned. If specified the change IDs will be reflective of the shared drive; use the combined drive ID and change ID as an identifier.
pageSizeinteger
The maximum number of changes to return per page.
pageTokenstringObligatorio
The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response or to the response from the getStartPageToken method.
includeLabelsstring
A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.
includeRemovedboolean
Whether to include changes indicating that items have been removed from the list of changes, for example by deletion or loss of access.
restrictToMyDriveboolean
Whether to restrict the results to changes inside the My Drive hierarchy. This omits changes to files such as those in the Application Data folder or shared files which have not been added to My Drive.
supportsAllDrivesboolean
Whether the requesting application supports both My Drives and shared drives.
includeCorpusRemovalsboolean
Whether changes should include the file resource if the file is still accessible by the user at the time of the request, even when a file was removed from the list of changes and there will be no further change entries for this file.
includeItemsFromAllDrivesboolean
Whether both My Drive and shared drive items should be included in results.
includePermissionsForViewstring
Specifies which additional view's permissions to include in the response. Only 'published' is supported.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List CommentsGOOGLEDRIVE_LIST_COMMENTSAcción

Tool to list all comments for a file in google drive. use when you need to retrieve comments associated with a specific file.

Parámetros de entrada

fieldsstring
A comma-separated list of fields to include in the response. Use `*` to include all fields.
fileIdstringObligatorio
The ID of the file.
pageSizeinteger
The maximum number of comments to return per page.
pageTokenstring
The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.
includeDeletedboolean
Whether to include deleted comments. Deleted comments will not include their original content.
startModifiedTimestring
The minimum value of 'modifiedTime' for the result comments (RFC 3339 date-time).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List File LabelsGOOGLEDRIVE_LIST_FILE_LABELSAcción

Tool to list the labels on a file. use when you need to retrieve all labels associated with a specific file in google drive.

Parámetros de entrada

file_idstringObligatorio
The ID of the file.
page_tokenstring
Token to retrieve a specific page of results.
max_resultsinteger
The maximum number of labels to return per page. Default is 100.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Files and FoldersGOOGLEDRIVE_LIST_FILESAcción

Tool to list a user's files and folders in google drive. use this to search or browse for files and folders based on various criteria.

Parámetros de entrada

qstring
A query string for filtering the file results. Supports operators like 'and', 'or', 'not', and can filter on fields like 'name', 'mimeType', 'modifiedTime', 'starred', 'trashed'. Example: "name contains 'important' and mimeType = 'application/vnd.google-apps.folder'".
fieldsstring
Selector specifying which fields to include in a partial response. This can be used to retrieve only specific file metadata, improving performance. Example: 'nextPageToken, files(id, name, mimeType, modifiedTime)'
spacesstring
A comma-separated list of spaces to query within the corpora. Supported values are 'drive' and 'appDataFolder'. 'drive' represents files in My Drive and shared drives, while 'appDataFolder' represents the application's private data folder.
corporastring
Specifies the bodies of items (files/documents) to which the query applies. Supported values are 'user', 'domain', 'drive', and 'allDrives'. It's generally more efficient to use 'user' or 'drive' instead of 'allDrives'. Defaults to 'user'.
driveIdstring
The ID of the shared drive to search. This is used when `corpora` is set to 'drive'.
orderBystring
A comma-separated list of sort keys. Valid keys include 'createdTime', 'folder', 'modifiedByMeTime', 'modifiedTime', 'name', 'name_natural', 'quotaBytesUsed', 'recency', 'sharedWithMeTime', 'starred', 'viewedByMeTime'. Each key sorts in ascending order by default, but can be reversed with the 'desc' modifier (e.g., 'modifiedTime desc').
folderIdstring
ID of a specific folder to list files from. This is a convenience parameter that automatically adds "'folder_id' in parents" to the query. Cannot be used together with a custom 'q' parameter.
pageSizeinteger
The maximum number of files to return per page. The value must be between 1 and 1000, inclusive. Defaults to 100.
pageTokenstring
The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.
includeLabelsstring
A comma-separated list of label IDs to include in the `labelInfo` part of the response for each file.
supportsAllDrivesboolean
Whether the requesting application supports both My Drives and shared drives. Defaults to false. If true, then `includeItemsFromAllDrives` can be used to extend the search to all drives.
includeItemsFromAllDrivesboolean
Whether to include items from both My Drive and shared drives. This is relevant when `corpora` is 'user' or 'domain'. Defaults to false.
includePermissionsForViewstring
Specifies which additional view's permissions to include in the response. Currently, only 'published' is supported, which includes permissions for files with published content.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List PermissionsGOOGLEDRIVE_LIST_PERMISSIONSAcción

Tool to list a file's permissions. use when you need to retrieve all permissions associated with a specific file or shared drive.

Parámetros de entrada

fileIdstringObligatorio
The ID of the file or shared drive.
pageSizeinteger
The maximum number of permissions to return per page. When not set for files in a shared drive, at most 100 results will be returned. When not set for files that are not in a shared drive, the entire list will be returned.
pageTokenstring
The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.
supportsAllDrivesboolean
Whether the requesting application supports both My Drives and shared drives. Default: false
useDomainAdminAccessboolean
Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.
includePermissionsForViewstring
Specifies which additional view's permissions to include in the response. Only 'published' is supported.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Replies to CommentGOOGLEDRIVE_LIST_REPLIES_TO_COMMENTAcción

Tool to list replies to a comment in google drive. use this when you need to retrieve all replies associated with a specific comment on a file.

Parámetros de entrada

fieldsstring
Selector specifying which fields to include in a partial response. Use '*' for all fields or e.g. 'replies(id,content),nextPageToken'
file_idstringObligatorio
The ID of the file.
page_sizeinteger
The maximum number of replies to return per page.
comment_idstringObligatorio
The ID of the comment.
page_tokenstring
The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.
include_deletedboolean
Whether to include deleted replies. Deleted replies will not include their original content.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List File RevisionsGOOGLEDRIVE_LIST_REVISIONSAcción

Tool to list a file's revisions. use when you need to retrieve the revision history of a specific file in google drive.

Parámetros de entrada

fileIdstringObligatorio
The ID of the file.
pageSizeinteger
The maximum number of revisions to return per page.
pageTokenstring
The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.
supportsAllDrivesboolean
Whether the requesting application supports both My Drives and shared drives. Defaults to false.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Shared DrivesGOOGLEDRIVE_LIST_SHARED_DRIVESAcción

Tool to list the user's shared drives. use when you need to get a list of all shared drives accessible to the authenticated user.

Parámetros de entrada

qstring
Query string for searching shared drives.
pageSizeinteger
Maximum number of shared drives to return per page.
pageTokenstring
Page token for shared drives.
useDomainAdminAccessboolean
Issue the request as a domain administrator. If set to true, then all shared drives of the domain in which the requester is an administrator are returned.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Move FileGOOGLEDRIVE_MOVE_FILEAcción

Tool to move a file from one folder to another in google drive. use when you need to reorganize files by changing their parent folder(s).

Parámetros de entrada

file_idstringObligatorio
The ID of the file to move.
add_parentsstring
A comma-separated list of parent folder IDs to add the file to. Use this to specify the destination folder.
ocr_languagestring
A language hint for OCR processing during image import (ISO 639-1 code).
include_labelsstring
A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.
remove_parentsstring
A comma-separated list of parent folder IDs to remove the file from. Use this to specify the source folder.
supports_all_drivesboolean
Whether the requesting application supports both My Drives and shared drives. Set to true if moving files to or from a shared drive.
keep_revision_foreverboolean
Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Google Drive.
include_permissions_for_viewstring
Specifies which additional view's permissions to include in the response. Only 'published' is supported.
use_content_as_indexable_textboolean
Whether to use the uploaded content as indexable text.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Export or download a fileGOOGLEDRIVE_PARSE_FILEAcción

Deprecated: exports google workspace files (max 10mb) to a specified format using `mime type`, or downloads other file types; use `googledrive download file` instead.

Parámetros de entrada

file_idstringObligatorio
The unique ID of the file stored in Google Drive that you want to export or download.
mime_typestringenum
Target MIME type for exporting Google Workspace documents (e.g., Docs, Sheets) to a different format (e.g., PDF, DOCX). Omit for direct download of non-Workspace files or if no conversion is needed for Workspace files.
application/vnd.openxmlformats-officedocument.wordprocessingml.documentapplication/vnd.oasis.opendocument.textapplication/rtfapplication/pdftext/plainapplication/zipapplication/epub+ziptext/markdownapplication/vnd.openxmlformats-officedocument.spreadsheetml.sheetapplication/x-vnd.oasis.opendocument.spreadsheettext/csvtext/tab-separated-values+7

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Stop Watch ChannelGOOGLEDRIVE_STOP_WATCH_CHANNELAcción

Tool to stop watching resources through a specified channel. use this when you want to stop receiving notifications for a previously established watch.

Parámetros de entrada

idstringObligatorio
The ID of the channel to stop.
kindstring
Identifies this as a notification channel used to watch for changes to a resource.
tokenstring
An arbitrary string delivered to the target address with each notification delivered over this channel.
paramsobject
Additional parameters controlling delivery channel behavior.
addressstring
The address where notifications are delivered for this channel.
payloadboolean
A Boolean value to indicate whether payload is wanted.
expirationstring
Date and time of notification channel expiration, expressed as a Unix timestamp, in milliseconds.
resourceIdstringObligatorio
The ID of the resource being watched.
channelTypestring
The type of delivery mechanism used for this channel. Valid values are "web_hook" or "webhook".
resourceUristring
A version-specific identifier for the watched resource.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Unhide Shared DriveGOOGLEDRIVE_UNHIDE_DRIVEAcción

Tool to unhide a shared drive. use when you need to restore a shared drive to the default view.

Parámetros de entrada

driveIdstringObligatorio
The ID of the shared drive.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Untrash FileGOOGLEDRIVE_UNTRASH_FILEAcción

Tool to restore a file from the trash. use when you need to recover a deleted file. this action updates the file's metadata to set the 'trashed' property to false.

Parámetros de entrada

file_idstringObligatorio
The ID of the file to untrash.
supportsAllDrivesboolean
Whether the requesting application supports both My Drives and shared drives.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update CommentGOOGLEDRIVE_UPDATE_COMMENTAcción

Tool to update an existing comment on a google drive file. use when you need to change the content or status (e.g., resolve) of a comment.

Parámetros de entrada

fieldsstring
Selector specifying which fields to include in a partial response. The API documentation states this is required. If not specified by the user, this action defaults to '*' to retrieve all fields, ensuring the API requirement is met. Example: 'id,content,resolved'.
contentstring
The plain text content of the comment. This field is used to update the comment's text. If not provided, the existing content will be retained unless 'resolved' is being updated.
file_idstringObligatorio
The ID of the file.
resolvedboolean
Whether the comment has been resolved. This can be used to mark a comment as resolved or reopen it.
comment_idstringObligatorio
The ID of the comment to update.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update Shared DriveGOOGLEDRIVE_UPDATE_DRIVEAcción

Tool to update the metadata for a shared drive. use when you need to modify properties like the name, theme, background image, or restrictions of a shared drive.

Parámetros de entrada

namestring
The new name for the shared drive.
hiddenboolean
Whether the shared drive is hidden from the default view.
driveIdstringObligatorio
The ID of the shared drive to update.
themeIdstring
The ID of a theme to apply to the shared drive. Cannot be set if colorRgb or backgroundImageFile are set.
colorRgbstring
The color of this shared drive as an RGB hex string (e.g., "#FF0000"). Cannot be set if themeId is set.
restrictionsobject
A set of restrictions to apply to the shared drive.
backgroundImageFileobject
An image file and cropping parameters for the shared drive's background. Cannot be set if themeId is set.
useDomainAdminAccessboolean
If set to true, the request is issued as a domain administrator.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update File (Metadata)GOOGLEDRIVE_UPDATE_FILE_PUTAcción

Updates file metadata. uses patch semantics (partial update) as per google drive api v3. use this tool to modify attributes of an existing file like its name, description, or parent folders. note: this action currently supports metadata updates only. file content updates require multipart/related upload and are not yet implemented.

Parámetros de entrada

namestring
The name of the file.
file_idstringObligatorio
The ID of the file to update.
starredboolean
Whether the user has starred the file.
mime_typestring
The MIME type of the file. Google Drive will attempt to automatically detect an appropriate value from uploaded content if no value is provided. The value cannot be changed unless a new revision is uploaded.
add_parentsstring
A comma-separated list of parent IDs to add.
descriptionstring
A short description of the file.
ocr_languagestring
A language hint for OCR processing during image import (ISO 639-1 code).
remove_parentsstring
A comma-separated list of parent IDs to remove.
writers_can_shareboolean
Whether writers can share the document with other users.
supports_all_drivesboolean
Whether the requesting application supports both My Drives and shared drives. This parameter will always be true by default if the application is configured to support shared drives.
keep_revision_foreverboolean
Whether to set this revision of the file to be kept forever. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions.
use_domain_admin_accessboolean
Whether the requesting application is using domain-wide delegation to access content belonging to a user in a different domain. This is only applicable to files with binary content in Google Drive.
viewers_can_copy_contentboolean
Whether viewers are prevented from copying content of the file.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update File Revision MetadataGOOGLEDRIVE_UPDATE_FILE_REVISION_METADATAAcción

Updates metadata of a file revision (e.g., keepforever, publish). use this tool to modify the metadata of a specific revision of a file in google drive.

Parámetros de entrada

file_idstringObligatorio
The ID of the file.
publishedboolean
Whether this revision is published. This is only applicable to Docs Editors files.
publishAutoboolean
Whether subsequent revisions will be automatically republished. This is only applicable to Docs Editors files.
revision_idstringObligatorio
The ID of the revision.
keep_foreverboolean
Whether to keep this revision forever, even if it is no longer the head revision. If not set, the revision will be automatically purged 30 days after newer content is uploaded. This can be set on a maximum of 200 revisions for a file. This field is only applicable to files with binary content in Drive.
publishedOutsideDomainboolean
Whether this revision is published outside the domain. This is only applicable to Docs Editors files.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update PermissionGOOGLEDRIVE_UPDATE_PERMISSIONAcción

Tool to update a permission with patch semantics. use when you need to modify an existing permission for a file or shared drive.

Parámetros de entrada

fileIdstringObligatorio
The ID of the file or shared drive.
permissionobjectObligatorio
The permission resource to update. Only 'role' and 'expirationTime' can be updated.
permissionIdstringObligatorio
The ID of the permission.
removeExpirationboolean
Whether to remove the expiration date.
supportsAllDrivesboolean
Whether the requesting application supports both My Drives and shared drives.
transferOwnershipboolean
Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect when set to true.
useDomainAdminAccessboolean
Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs.
enforceExpansiveAccessboolean
Whether the request should enforce expansive access rules. This field is deprecated, it is recommended to use `permissionDetails` instead.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update ReplyGOOGLEDRIVE_UPDATE_REPLYAcción

Tool to update a reply to a comment on a google drive file. use when you need to modify the content of an existing reply.

Parámetros de entrada

fieldsstringObligatorio
Selector specifying which fields to include in a partial response.
contentstringObligatorio
The new plain text content of the reply.
file_idstringObligatorio
The ID of the file.
reply_idstringObligatorio
The ID of the reply.
comment_idstringObligatorio
The ID of the comment.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Upload FileGOOGLEDRIVE_UPLOAD_FILEAcción

Uploads a file (max 5mb) to google drive, moving it to a specified folder if a valid folder id is provided, otherwise uploads to root.

Parámetros de entrada

file_to_uploadobjectObligatorio
File to upload to Google Drive (max 5MB), identified by its name or path.
folder_to_upload_tostring
Optional ID of the target Google Drive folder; can be obtained using 'Find Folder' or similar actions.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Watch Drive ChangesGOOGLEDRIVE_WATCH_CHANGESAcción

Tool to subscribe to changes for a user or shared drive in google drive. use when you need to monitor a google drive for modifications and receive notifications at a specified webhook url.

Parámetros de entrada

idstringObligatorio
A unique string that identifies this channel. UUIDs are recommended.
typestringObligatorio
The type of delivery mechanism for notifications (e.g., 'web_hook').
tokenstring
An arbitrary string that will be delivered with each notification. Can be used for verification.
paramsobject
Optional parameters for the notification channel. Example: {"ttl": "3600"} for a 1-hour time-to-live (actual support depends on Google API).
spacesstring
A comma-separated list of spaces to query within the corpora. Supported values are 'drive' and 'appDataFolder'.
addressstringObligatoriouri
The URL where notifications are to be delivered.
drive_idstring
The shared drive from which changes will be returned. If specified, change IDs will be specific to the shared drive.
page_sizeinteger
The maximum number of changes to return per page.
expirationinteger
Timestamp in milliseconds since the epoch for when the channel should expire. If not set, channel may not expire or have a default expiration.
page_tokenstring
The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response or to the response from the getStartPageToken method.
include_labelsstring
A comma-separated list of IDs of labels to include in the labelInfo part of the response.
include_removedboolean
Whether to include changes indicating that items have been removed from the list of changes (e.g., by deletion or loss of access).
supports_all_drivesboolean
Whether the requesting application supports both My Drives and shared drives. Recommended to set to true if driveId is used or if interactions with shared drives are expected.
restrict_to_my_driveboolean
Whether to restrict the results to changes inside the My Drive hierarchy. This omits changes to files like those in the Application Data folder or shared files not added to My Drive.
include_corpus_removalsboolean
Whether changes should include the file resource if the file is still accessible by the user at the time of the request, even when a file was removed from the list of changes.
include_permissions_for_viewstring
Specifies which additional view's permissions to include in the response. Only 'published' is supported.
include_items_from_all_drivesboolean
Whether both My Drive and shared drive items should be included in results.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Triggers (7)

Los triggers son eventos externos que pueden iniciar un flujo en tus agentes (ej: nuevo email, mensaje recibido, registro creado).

Comment Added (Docs/Sheets/Slides)GOOGLEDRIVE_COMMENT_ADDED_TRIGGERTrigger

Triggers when a new comment is added to Google Docs, Sheets, or Slides.

Configuración

file_idstring
If provided, monitor comments only for this specific file ID. If omitted, the trigger scans recent Docs/Sheets/Slides files for new comments.
intervalnumber
Periodic Interval to Check for Updates & Send a Trigger in Minutes
max_filesinteger
Maximum number of recent Docs/Sheets/Slides files to inspect in each poll when no file ID is specified. Values above 100 are clamped at runtime to protect Drive quota — comments.list is a per-file fanout.

Payload del evento

comment_idstringObligatorio
The ID of the comment
comment_textstring
The plain text content of the comment
commenterobject
Information about the commenter (displayName, permissionId, photoLink, me).
created_timestring
The time the comment was created (RFC 3339)
file_idstringObligatorio
The ID of the file on which the comment was added

Instrucciones

This trigger monitors Google Docs, Sheets, and Slides for new comments. Provide a specific File ID to monitor a particular document, or leave it empty to scan a bounded set of recent Docs/Sheets/Slides files each poll. The trigger only fires for newly created root comments — it does not fire on replies or edits to existing comments. The cursor is provider-derived from `comment.createdTime`, not local wall clock. On the first run the trigger initializes state and does not emit past comments.

File CreatedGOOGLEDRIVE_FILE_CREATED_TRIGGERTrigger

Triggers when a new file is created in Google Drive.

Configuración

folder_idstring
If provided, monitor only files within this folder (by folder ID). Adds the filter `'folder_id' in parents` to the query.
intervalnumber
Periodic Interval to Check for Updates & Send a Trigger in Minutes
max_resultsinteger
Maximum number of newly-created files to emit in a single poll. Acts as an event cap, not an API page size — the trigger paginates Drive responses internally.
querystring
Optional Drive search query to filter files. Examples: name contains 'report', mimeType = 'application/pdf', or complex queries like name contains 'project' and mimeType != 'application/vnd.google-apps.folder'. Leave empty to monitor all files.

Payload del evento

creatorobject
Information about the file's creator (derived as first owner if available)
event_typestring
Type of event that occurred
fileobjectObligatorio
The newly created Google Drive file

Instrucciones

Instructions for setting up the trigger: - This trigger monitors Google Drive for newly created files. - You can optionally provide a search query to filter which files to monitor. - You can optionally limit monitoring to a specific parent folder by ID. - On the first run the trigger baselines to the current time and emits no past events. - Subsequent polls return files created since the previous poll. - The cursor is provider-derived from `file.createdTime`, not local wall clock — clock skew between the poller and Google does not affect it.

File Deleted or TrashedGOOGLEDRIVE_FILE_DELETED_OR_TRASHED_TRIGGERTrigger

Triggers when a file is moved to trash or permanently deleted in Drive.

Configuración

drive_idstring
Optional shared drive ID to monitor. When unset, the trigger monitors My Drive plus shared drives surfaced by `include_items_from_all_drives`.
include_corpus_removalsboolean
Include changes where the user lost access to the file (e.g. permission removal). When false, only true deletions and trash events surface.
include_items_from_all_drivesboolean
Whether items from My Drive AND all visible shared drives should appear in results.
intervalnumber
Periodic Interval to Check for Updates & Send a Trigger in Minutes
page_sizeinteger
Maximum number of changes per `changes.list` page (1-1000).
restrict_to_my_driveboolean
If true, restrict results to changes inside the My Drive hierarchy.
spacesstring
Comma-separated list of spaces to query. Supported values are 'drive' and 'appDataFolder'.

Payload del evento

deletion_timestampstringObligatorio
Timestamp of the delete/trash event in RFC 3339 format
event_typestringObligatorio
Type of deletion event. Either 'trashed' (soft-delete, recoverable from the user's trash) or 'removed' (hard-delete or, when include_corpus_removals=true, access loss).
file_idstringObligatorio
ID of the file that was deleted or trashed
namestring
Name of the file. May be absent when the file was permanently removed (the file resource is gone, only the change record remains).

Instrucciones

This trigger monitors Google Drive for files that are moved to trash or permanently deleted. Each payload carries an `event_type`: 'trashed' for soft-delete (file is recoverable from the user's trash) or 'removed' (hard-delete; when `include_corpus_removals` is true, also covers access-loss events — Drive's API does not let us distinguish those from hard deletes). On first run, the trigger baselines to the current change cursor and emits no events.

File Shared (Permissions Added)GOOGLEDRIVE_FILE_SHARED_PERMISSIONS_ADDEDTrigger

Triggers when new sharing permissions are granted to a file or folder. Uses Drive's `changes.list` endpoint with inline `permissions` in the `fields` mask so each change carries the file's current permission set provider-atomically. We diff that against `seen_permission_keys` to identify newly added grants. Drive page tokens are the primary cursor; if Drive rejects a stored token, the trigger raises `PollingTriggerError` without clearing state rather than silently re-baselining and dropping events. Limitation: truly ephemeral permissions (added and revoked between two polls without any other file modification in between) are not detected. Drive Activity API would catch those but requires an additional OAuth scope and a different payload contract.

Configuración

drive_idstring
The shared drive ID to monitor. If omitted, monitors My Drive and any shared drives surfaced via include_items_from_all_drives.
file_idstring
If provided, only emit permission changes for this specific file or folder ID.
intervalnumber
Periodic Interval to Check for Updates & Send a Trigger in Minutes
page_sizeinteger
Maximum number of changes to fetch per `changes.list` page (1-1000).
supports_all_drivesboolean
Whether to include both My Drive and shared drives when monitoring changes.

Payload del evento

event_typestring
Type of event that occurred
new_permissionsobject[]
List of newly detected permissions

Instrucciones

This trigger fires when new sharing permissions are added to files or folders in your Google Drive. Optionally specify a 'file_id' to monitor only a single file or folder. Inherited permissions (from shared parent folders or drives) are filtered out — only direct shares fire the trigger. The cursor is the Drive `pageToken` from the Changes API; a rejected cursor surfaces as a polling error without clearing state.

File UpdatedGOOGLEDRIVE_FILE_UPDATED_TRIGGERTrigger

Triggers when a file's metadata or content changes in Google Drive.

Configuración

content_onlyboolean
When true, fire only on content changes (new revision) and suppress metadata-only updates such as rename or move. Relies on `headRevisionId`, which Drive only exposes for binary files — Google-native docs (Docs/Sheets/Slides) do not carry `headRevisionId` and will not fire this trigger under `content_only=true`.
drive_idstring
Optional shared drive ID to monitor. When unset, the trigger monitors My Drive plus shared drives surfaced by `include_items_from_all_drives`.
include_items_from_all_drivesboolean
Whether items from My Drive AND all visible shared drives should appear in results.
intervalnumber
Periodic Interval to Check for Updates & Send a Trigger in Minutes
page_sizeinteger
Maximum number of changes per `changes.list` page (1-1000).

Payload del evento

file_idstringObligatorio
The ID of the file that changed
last_modifying_userobject
Information about the last user who modified the file
modified_timestring
The last time the file was modified (RFC 3339 date-time)

Instrucciones

Instructions for setting up the trigger: - This trigger monitors Google Drive changes using the Changes API. - On first run, it baselines to the current change cursor and emits no events. - Subsequent polls return file updates that occurred since the previous poll. - Trashed files do not fire this trigger; the file_deleted_or_trashed trigger handles those events instead. - Set `content_only=true` to suppress metadata-only updates (rename, move, share) and fire only when the file's head revision changes. Note this only works for binary files — Google-native docs (Docs/Sheets/Slides) do not expose `headRevisionId`. - You can optionally limit to a specific shared drive by providing drive_id.

Google Drive ChangesGOOGLEDRIVE_GOOGLE_DRIVE_CHANGESTrigger

Triggers when changes are detected in a Google Drive.

Configuración

drive_idstring
Optional shared drive ID to monitor. When unset, the trigger monitors the user's My Drive plus any shared drives surfaced by `include_items_from_all_drives`.
include_items_from_all_drivesboolean
Whether items from My Drive AND all visible shared drives should appear in results. Required for shared-drive coverage.
intervalnumber
Periodic Interval to Check for Updates & Send a Trigger in Minutes
restrict_to_my_driveboolean
If true, restrict results to changes inside the My Drive hierarchy even when `include_items_from_all_drives` is true.
spacesstring
Comma-separated list of spaces to query. Supported values are 'drive' and 'appDataFolder'.

Payload del evento

Sin parámetros.

Instrucciones

**Instructions for Setting Up the Trigger:** - Ensure you have set the necessary permissions to access Google Drive. - On first run the trigger baselines to the current change cursor and emits no events; subsequent polls return any changes that occurred since the previous poll. - If Drive rejects a stored page token, the trigger raises an error instead of silently re-baselining and dropping events in the gap.

New File Matching QueryGOOGLEDRIVE_NEW_FILE_MATCHING_QUERY_TRIGGERTrigger

Triggers when a new Google Drive file matches a provided query. This is the legacy query-centric trigger: it preserves Drive API query config such as ``corpora`` / ``driveId`` aliases and emits the historical ``file_matching_query`` event type. ``FileCreatedTrigger`` covers the broader "new file" case and emits ``file_created``.

Configuración

corporastring
Bodies of items to which the query applies. Supported: 'user', 'domain', 'drive', 'allDrives'.
driveIdstring
ID of the shared drive to search (use with corpora='drive').
includeItemsFromAllDrivesboolean
Include items from both My Drive and shared drives.
intervalnumber
Periodic Interval to Check for Updates & Send a Trigger in Minutes
max_resultsinteger
Maximum number of newly-matching files to emit per poll. The trigger paginates Drive responses internally bounded by an internal page cap; this field caps emitted events, not API pages.
querystring
Drive query to filter files. Examples: name contains 'report', mimeType = 'application/pdf', (name contains 'Draft' and not trashed). The query is composed with a `createdTime >= <watermark>` boundary plus ID dedup so the trigger only fires for newly created files.
spacesstring
A comma-separated list of spaces to query within. Supported: 'drive', 'appDataFolder'.
supportsAllDrivesboolean
Whether the requesting application supports both My Drives and shared drives.

Payload del evento

event_typestring
Type of event that occurred
fileobjectObligatorio
The newly matched Drive file

Instrucciones

This trigger monitors Google Drive and fires when a newly created file matches your query. Provide a Drive 'q' query (e.g. `name contains 'X'` or `mimeType = 'application/pdf'`). The cursor is provider-derived from `file.createdTime`, not local wall clock. On the first run the trigger initializes state and does not emit past files.