The advanced Drive service allows you to use the Google Drive API in Apps Script. Much like Apps Script's built-in Drive service, this API allows scripts to create, find, and modify files and folders in Google Drive. In most cases, the built-in service is easier to use, but this advanced service provides a few extra features, including access to custom file properties as well as revisions for files and folders.
Reference
For detailed information on this service, see the reference documentation for the Google Drive API. Like all advanced services in Apps Script, the advanced Drive service uses the same objects, methods, and parameters as the public API. For more information, see How method signatures are determined.
To report issues and find other support, see the Drive v2 support guide.
Sample code
The sample code below uses version 2 of the API.
Uploading files
The following example demonstrates how to save a file to a user's Drive.
Listing folders
The following example demonstrates how to list the top-level folders in the user's Drive. Notice the use of page tokens to access the full list of results.
Listing revisions
The following example demonstrates how to list the revisions for a given file.
Note that some properties of revisions are only available for certain file
types. For example, Google Workspace application files
do not consume space in Google Drive and
thus return a file size of 0
.
Adding custom properties
The following example demonstrates how to add a custom property to a file.
Unlike Apps Script's document properties,
Drive's custom file properties can be accessed outside of Apps Script and by
other applications (if the visibility is set to PUBLIC
).