Google Drive
The Google Drive modules enable you to monitor, search, create, update, delete, and manage your files, folder, or shared drives in your Google Drive.
Getting Started with Google Drive
Prerequisites
A Google account
In order to use Google Drive with Make, it is necessary to have a Google account. If you do not have one, you can create a Google account at accounts.google.com/signup.
Note
The module dialog fields that are displayed in bold (in the Make scenario, not in this documentation article) are mandatory!
To connect your Google Drive account to Make as a G Suite user (Business Gmail account) follow the general instructions for Connecting to services.
After you click the Continue button, Make will redirect you to the Google website where you will be prompted to grant Make access to your account:

Here, allow access by clicking the Allow button. Afterwards, you will be redirected back to the Make scenario. Now, you can continue creating your scenario.
If you are @gmail.com or @googlemail.com user you need to create an OAuth client on the Google Cloud Platform in order to obtain Client ID and Client Secret. For step-by-step instructions on how to create the OAuth client (and obtain Client ID and Client Secret) please refer to the Connecting If you are @gmail.com or @googlemail.com user you need to create an OAuth client on the Google Cloud Platform in order to obtain Client ID and Client Secret. For step-by-step instructions on how to create the OAuth client (and obtain Client ID and Client Secret) please refer to the Connecting Make To Google Services Using a Custom OAuth Client documentation or see the video tutorial below.
To find out whether you are G Suite user or @gmail user please see the Google API restrictions (Do I have a G Suite account? section) article.
Watch Files In a Folder
Retrieves file details when a file is added or modified in the specified folder.
Note
In order to retrieve the Share Link and Web Content Link, please use the Get a Share Link module.
Note
To download a retrieved file, please use the Download a File module in your scenario.
Connection | |
Watch Files | Select whether you want to watch new files in the folder (By Created Time), or modified files (By Modified Time). |
Choose a Drive | Select whether you want to watch files in one of the following locations:
|
Select the Folder to be Watched | Navigate to the folder you want to watch. |
File Types to Watch | Select file type to filter watched files by. |
Limit | Set the maximum number of files Make will return during one execution cycle. |
Watch All Files
Retrieves file details when a file in your Google Drive is added or modified.
Note
In order to retrieve the Share Link and Web Content Link, please use the Get a Share Link module.
Note
To download a retrieved file, please use the Download a File module in your scenario.
Connection | |
Watch Files | Select whether you want to watch new files in the folder (By Created Time), or modified files (By Modified Time). |
Choose a Drive | Select whether you want to watch files in one of the following locations:
|
File Types to Watch | Select file type to filter watched files by. |
Limit | Set the maximum number of files Make will return during one execution cycle. |
Watch Folder
Retrieves folder details when a new folder is created or the existing one is modified.
Connection | |
Watch Files | Select whether you want to watch new folders (By Created Time), or modified folders (By Modified Time). |
Choose a Drive | Select whether you want to watch folders in one of the following locations:
|
Choose a Folder | Navigate to the folder you want to watch for the folders. |
Limit | Set the maximum number of folders Make will return during one execution cycle. |
Search for Files/Folders
Searches for files or folders based on search criteria.
Connection | |||||||
Choose a Drive | Select the location where you want to search for files or folders:
| ||||||
Choose a Folder | Navigate to the folder you want to search for the files or folders. | ||||||
Retrieve | Select whether you want to search for files, folders, or both. | ||||||
Search | Select the type of the search you want to perform.
| ||||||
Query | Enter the query (differs based on the search type selected in the Search field above).
| ||||||
Limit | Set the maximum number of files or folders Make will return during one execution cycle. |
Download a File
Downloads a file from your Google Drive.
Connection | |
Choose a Drive | Select the location where you want to download a file from:
|
Enter a File ID | Select whether you want to enter (map) the file ID manually or select the file using the menu. |
File ID | Enter (map) the file ID of the file you want to download. |
Convert Google Documents/Spreadsheets/Slides/Drawings Files to Format | Select the file type of the file you want to download and target file type you want convert to the file to. |
Create a File From Text
Creates a file in the selected Google Drive folder.
Connection | |
Choose a Drive | Select the location where you want to create the file at:
|
New Text File Location | Select the target location where you want to create the new file. |
File Name | Enter the name for the new file. |
File Content | Enter the plain text content of the new file. |
Convert the File to Google Docs Document | Enable this to set the file's mimeType to application/vnd.google-apps.document instead of text/plain. |
Create a Folder
Creates a folder in the specified location.
Connection | |
Choose a drive | Select the drive where you want to create the folder:
|
New Folder Location | Select the target location where you want to create the new folder. |
New Folder's Name | Enter the name for the new folder. |
Share Folder | If enabled, the folder is shared to anyone with the link of the folder (Web View Link). Otherwise the Web View Link works for the owners only. |
Type | Select permission for the folder. A permission grants a user, group, domain, or the world access to a folder hierarchy. |
Role | Select the role to define what users can do with a file or folder. For the list of operations users can perform for each role please refer to the Roles documentation. |
Upload a File
Uploads a file to your Google Drive.
Connection | |
Enter a Folder ID | Select whether you want to enter (map) the folder ID manually or select the folder using the menu. |
Folder ID | Enter (map) the folder ID of the folder you want to upload the file to. |
New File Name | Enter the new file name if you want to change the name of the file. |
Source File | Map the file you want to upload from the previous module (e.g. HTTP > Get a File or Dropbox > Get a file), or enter the file name and file data manually. |
Update a File
Updates a file's metadata or content.
Connection | |
Enter a File ID | Select whether you want to enter (map) the file ID manually or select the file using the menu. |
File ID | Enter (map) the File ID of the file you want to update. |
New Updated File Name | Enter the new file name if you want to change the name of the file. |
File Description | Enter the new file description. |
Change File Content | Enable this option to change the file content. The new file must have the same |
Source File | Map the file you want to upload from the previous module (e.g. HTTP > Get a File or Dropbox > Get a file), or enter the file name and file data manually. |
Move a File/Folder to Trash
Moves a file or folder to the trash.
Connection | Establish a connection to your Google Drive. |
Enter a File/Folder ID | Select whether you want to enter (map) the file or folder ID manually or select the file or folder using the menu. |
Select File/Folder | Select whether you want to move the file or folder to the trash. |
File ID / Folder ID | Enter (map) the File ID (or folder ID) of the file (or folder) you want to move to the trash. |
Delete a File/Folder.
Permanently deletes a file or folder.
Connection | Establish a connection to your Google Drive. |
Enter a File/Folder ID | Select whether you want to enter (map) the file or folder ID manually or select the file or folder using the menu. |
Select File/Folder | Select whether you want to permanently delete a file or folder. |
File ID / Folder ID | Enter (map) the File ID (or folder ID) of the file (or folder) you want to permanently delete. |
Copy a File
Copies a file to the new location.
Connection | |
Original File's Drive | Select the drive you want to copy the file from:
|
Original File ID | Enter (map) the File ID of the original file you want to copy. |
New Drive Location | Select the target drive you want to copy the file to:
|
New Folder Location | Select the target folder you want to copy the file to. |
Copied File Name | Enter the new file name if you want to change the name of the file in the target location. |
Move a File/Folder
Moves a file or folder to the new target location.
Connection | |
Choose a Drive | Select the drive you want to move the file or folder from:
|
Select File/Folder | Select whether you want to move a file or folder. |
File ID/ Folder ID | Enter (map) the File ID (or Folder ID) of the file (or folder) you want to move. |
New Drive Location | Select the target drive you want to move the file or folder to:
|
New Folder Location | Select the target folder you want to move the file or folder to. |
Watch Comments
Triggers when a comment is added or modified on the selected file.
Connection | |
Watch Comments | Select whether you want to watch new comments (By Created Time), or modified comments (By Modified Time). |
Choose a Drive | Select whether you want to watch comments in one of the following locations:
|
File ID | Navigate to and select the file you want to watch for comments. |
Limit | Set the maximum number of comments Make will return during one execution cycle. |
Make an API Call
Allows you to perform a custom API call.
Connection | |
URL | Enter a path relative to NoteFor the list of available endpoints, refer to the Google Drive API Documentation. |
Method | Select the HTTP method you want to use:
|
Headers | Enter the desired request headers. You don't have to add authorization headers; we already did that for you. |
Query String | Enter the request query string. |
Body | Enter the body content for your API call. |
The following API call returns all files in your Google Drive:
URL:
/v3/files
Method:
GET

The result can be found in the module's Output under Bundle > Body > files. In our example, 30 files were returned:

In the module Search for Files/Folders you can use your own query which consists of these parts:
Field - Attribute of the file that is being searched, e.g. the attribute name
of the file.
Operator - Test that is performed on the data to provide a match, e.g. contains
.
Value - The content of the attribute that is tested, e.g. the name of the file My cool document
.
Combine clauses with the conjunctions and
or or
, and negate the query with not
.
Fields
Term | Valid operators | Usage |
---|---|---|
|
| Name of the file. Surround with single quotes |
| Full text of the file including name, description, content, and indexable text. Whether the 'title', 'description', or 'indexableText' properties, or the content of the file matches. Surround with single quotes | |
|
| MIME type of the file. Surround with single quotes |
|
| Date of the last modification of the file. RFC 3339 format, default timezone is UTC, e.g., |
|
| Date that the user last viewed a file. RFC 3339 format, default timezone is UTC, e.g., |
|
| Whether the file is in the trash or not. Can be either |
|
| Whether the file is starred or not. Can be either |
|
| Whether the parents collection contains the specified ID. |
|
| Users who own the file. |
|
| Users or groups who have permission to modify the file. See Permissions resource reference. |
|
| Users or groups who have permission to read the file. See Permissions resource reference. |
|
| Files that are in the user's "Shared with me" collection. All file users are in the file's access control list (ACL). Can be either |
|
| Public custom file properties. |
|
| Private custom file properties. |
|
| The visibility level of the file. Valid values are anyoneCanFind, anyoneWithLink, domainCanFind, domainWithLink, and limited. Surround with single quotes |
[1] The contains
operator only performs prefix matching for a name
. For example, the name "HelloWorld" would match for name contains 'Hello'
but not name contains 'World'
.
[2] The contains
operator only performs matching on entire string tokens for fullText
. For example, if the full text of a doc contains the string "HelloWorld" only the query fullText contains 'HelloWorld'
returns a result. Queries such as fullText contains 'Hello'
do not return results in this scenario.
[3] The contains
operator matches on an exact alphanumeric phrase if it is surrounded by double quotes. For example, if the fullText
of a doc contains the string "Hello there world", then the query fullText contains '"Hello there"'
returns a result, but the query fullText contains '"Hello world"'
doesn't. Furthermore, since the search is alphanumeric, if the fullText
of a doc contains the string "Hello_world", then the query fullText contains '"Hello world"'
returns a result.
[4] The owners
, writers
and readers
properties are indirectly reflected in the list and refer to the role on the permission.
Value types
Value Type | Notes |
---|---|
String | Surround with single quotes |
Boolean |
|
Date | RFC 3339 format, default timezone is UTC, e.g., |
Operators
Operator | Usage |
---|---|
| The content of one string is present in the other. |
| The content of a string or boolean is equal to the other. |
| The content of a string or boolean is not equal to the other. |
| A value is less than another. |
| A value is less than or equal to another. |
| A value is greater than another. |
| A value is greater than or equal to another. |
| An element is contained within a collection. |
| Return items that match both queries. |
| Return items that match either query. |
| Negates a search query. |
| A collection contains an element matching the parameters. |
For compound clauses, you can use parentheses to group clauses together. For example:
modifiedTime > '2019-06-04T12:00:00' and (mimeType contains 'image/' or mimeType contains 'video/')
This search returns all files with an image or video MIME type that their last modification was after June 4, 2019. Because and
and or
operators are evaluated from left to right, without parentheses, the above example would return only images modified after June 4, 2019, but would return all videos, even those before June 4, 2019.
Examples
Files with the name "hello" |
|
Files with a name containing the words "hello" and "goodbye" |
|
Files with a name that does not contain the word "hello" |
|
Folders that are Google apps or have the folder MIME type |
|
Files that are not folders |
|
Files that contain the text "important" and in the trash |
|
Files that contain the word "hello" |
|
Files that do not have the word "hello" |
|
Files that contain the exact phrase "hello world" |
|
Files with a query that contains the "" character (e.g., "\authors") |
|
Files with ID within a collection, e.g. |
|
Files in an Application data folder in a collection |
|
Files for which user "test@example.org" has write permission |
|
Files for which members of the group "group@example.org" have write permission |
|
Files modified after a given date |
|
Files shared with the authorized user with "hello" in the name |
|
Files that have not been shared with anyone or domains (only private, or shared with specific users or groups) |
|
Image or video files modified after a specific date |
|
(Reference: Google Drive API v3 - Search for files and folders, Google Drive API v3 - Search query terms)
There are several situations when uploading or updating a file fails:
The uploaded file is too big and exceeds the maximum file size limit allowed for your Google Drive plan or you have exceeded your Google Drive storage limit. You can either upgrade your storage plan or delete existing files from the Google Drive service.
The selected folder where the file was to be uploaded to no longer exists. The scenario stops and it is then necessary to select a target folder again.
Your connection has expired and is no longer valid. You need to reauthorize the connection.
This error affects non-Gsuite Google accounts. For more details please refer to the Google OAuth documentation.
Solution
Reauthorize your Google connection.
1. Log in to Make.
2. Navigate to Connections.

3. Find your Google connection and click Reauthorize button.

To prevent the expiration of your Google connection, we suggest you to reauthorize the connection every week.
last update: 2020-06-08
All modules now support all instances - My Drive, Shared With Me, Google Shared Drive (G Suite). The app Google Team Drive is not available as the Google Drive app now supports the same methods. The group of modules Google Shared Drive(for G Suite users) has been newly added:
Watch Shared Drives
Search for Shared Drives
Get a Shared Drive
Update a Shared Drive
Delete a Shared Drive
Create a Shared Drive
Watch Files in a Folder - The new module helps the user to control used data and operations by not downloading the files. If needed, the file can be downloaded using the separate Download a File module.
Watch All Files - The new module helps the user to control used data and operations by not downloading the files. If needed, the file can be downloaded using the separate Download a File module.
Upload a File/Update a File - advanced feature Convert a File - the solution working with a MIME type.
All modules - Use the separate Recognize a Folder Path module to retrieve the folder ID.
Get a Share Link - supports advanced modifications of rights for the share link.
Download a File - formerly Get a File. Now you can manually select the file you want to download.
Copy a File/Move a File - all instances are supported, e.g. you may copy/move a file from "My Drive" to "G Shared Drive".
Create a Folder - the Share folder feature - supports advanced modifications of rights for the Share link.
Create a File from Text - a new module
Move a File/Folder to Trash - legacy module could trash only files. The new one supports also empty folders.
Delete a File/Folder - legacy module could delete only files. The new one supports also empty folders.
Make an API Call - universal module
Watch Shared Files - deprecated, now the modules Watch All Files or Watch Files in a Folder may be used.