# Google Drive trigger - New file or folder

Triggers immediately in real time when a new file or folder is created in a specified folder. Subfolders are not monitored.

Google Drive New file or folder trigger Google Drive New file or folder trigger

# Input fields

Field name Description
Folder The folder to monitor for new files or folders. Subfolders are not monitored. Select a folder from the picklist or enter the folder ID directly. If entering the folder ID for a shared drive (formerly Team Drive), this value must be in the form folder_id/shared_drive_id (for example, 1fm6iCMYrN7roZZ-ynpVFRTVq9mellrWp/0AB6ZFCw3XdamUk9PAA). IDs can be found at the end of folder and drive URLs.
When first started, this recipe should pick up events from When you start recipe for the first time, it picks up new files or folders created from this specified date and time. If left blank, the recipe picks up files or folders created an hour ago. After the recipe has been run or tested, the value cannot be changed. Refer to Triggers for more information.
Chunk size (KB) Configure this to optimize throughput. Larger chunk size increases throughput, but may hit API limits. Defaults to 1024 KB. Refer to File streaming for more information.

# Output fields

Note that in Google Drive API, the terms folder and file are used interchangeably. A folder is technically a special file. As a result, whenever the field name or field description mentions file, it also applies to folder.

Is folder
Whether this is a folder.
Is Google file
Whether this is a Google file, such as Google Sheets, Google Docs, Google Slides, and so on.
Is other file
Whether this is a non-Google file, such as a CSV, PDF, DOCX, and so on.
File contents
Full contents of the file. This is a streaming object.
ID
ID of the file.
Name
Name of the file or folder.
MIME type
MIME type of this file, as stated in Google Drive's documentation.
Description
A short description of the file.
Starred
Whether the user has starred the file.
Trashed
Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner can trash a file. Other users cannot see files in the owner's trash.
Explicitly trashed
Whether the file has been explicitly trashed, as opposed to recursively trashed from a parent folder (for example, when you trash an entire parent folder).
Parents
The list of the parent folders that contain the file. Each parent folder in the list contains the following output field, in addition to List size and List index:
ID
The ID of the parent folder containing the file.
Version
A version number for the file. This reflects every change made to the file on the server, even those not visible to the user.
Web content link
A link for downloading the content of the file in a browser. This is only available for files with binary content in Google Drive.
Web view link
A link for opening the file in a relevant Google editor or viewer in a browser.
Icon link
A static, unauthenticated link to the file's icon.
Thumbnail link
A short-lived link to the file's thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file's content.
Viewed by me
Whether the file has been viewed by this user.
Viewed by me time
The last time the file was viewed by this user (RFC 3339 date-time).
Created time
The time at which the file was created (RFC 3339 date-time).
Modified time
The last time the file was modified by anyone (RFC 3339 date-time).
Modified by me time
The last time the file was modified by this user (RFC 3339 date-time).
Sharing user
The user who shared the file with the requesting user, if applicable. Each user contains the following output fields:
Display name
A plain text displayable name for this user.
Email address
The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester.
Permission ID
The user's ID as visible in Permission resources.
Photo link
A link to the user's profile photo, if available.
Me
Whether this user is the requesting user.
Owners
The list of owners of the file. Only certain legacy files can have more than one owner. This field is not populated for shared drive files. Each owner contains the following fields, in addition to List size and List index:
Display name
A plain text displayable name for this user.
Email address
The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester.
Permission ID
The user's ID as visible in Permission resources.
Photo link
A link to the user's profile photo, if available.
Me
Whether this user is the requesting user.
Last modifying user
The last user to modify the file. Each user contains the following output fields:
Display name
A plain text displayable name for this user.
Email address
The email address of the user. This may not be present in certain contexts if the user has not made their email address visible to the requester.
Permission ID
The user's ID as visible in Permission resources.
Photo link
A link to the user's profile photo, if available.
Me
Whether this user is the requesting user.
Shared
Whether the file has been shared. This field is not populated for shared drive files.
Owned by me
Whether the user owns the file. This field is not populated for shared drive files.
Viewers can copy content
Whether users with View access can copy the file contents.
Writers can share
Whether users with Edit access can share the file. This field is not populated for shared drive files.
Original filename
The original filename of the uploaded content if available, or else the original value of the name field. This is only available for files with binary content in Google Drive.
Full file extension
The full file extension extracted from the name field. May contain multiple concatenated extensions (for example, tar.gz). This is only available for files with binary content in Google Drive. It is automatically updated when the name field changes, but it is not cleared if the new name does not contain a valid extension.
File extension
The final component of the full file extension (for example, gz). This is only available for files with binary content in Google Drive.
MD5 checksum
The MD5 checksum for the content of the file. This is only applicable to files with binary content in Google Drive.
Size
The size of the file's content in bytes. This is only applicable to files with binary content in Google Drive.
Quota bytes used
The number of storage quota bytes used by the file. This includes the head revision as well as previous revisions with Keep Forever enabled.
Head revision ID
The ID of the file's most current version. This is only available for files with binary content in Google Drive.


Last updated: 1/9/2024, 3:57:00 PM