7/17/25, 9:47 AM Google Drive API | Google for Developers
Google Drive API
The Google Drive API allows clients to access resources from Google Drive.
Service: googleapis.com/drive/v3
To call this service, we recommend that you use the Google-provided client libraries
(https://cloud.google.com/apis/docs/client-libraries-explained). If your application needs to use your own libraries to call this service, use the
following information when you make the API requests.
Discovery document
A Discovery Document (https://developers.google.com/discovery/v1/reference/apis) is a machine-readable specification for describing and
consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may
provide multiple discovery documents. This service provides the following discovery document:
https://www.googleapis.com/discovery/v1/apis/drive/v3/rest (https://www.googleapis.com/discovery/v1/apis/drive/v3/rest)
Service endpoint
A service endpoint (https://cloud.google.com/apis/design/glossary#api_service_endpoint) is a base URL that specifies the network address of an
API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are
relative to this service endpoint:
https://www.googleapis.com
https://developers.google.com/workspace/drive/api/reference/rest/v3 1/11
7/17/25, 9:47 AM Google Drive API | Google for Developers
REST Resource: v3.about (/workspace/drive/api/reference/rest/v3/about)
Methods
get GET /drive/v3/about
(/workspace/drive/api/reference/rest/ Gets information about the user, the user's Drive, and system capabilities.
v3/about/get)
REST Resource: v3.accessproposals (/workspace/drive/api/reference/rest/v3/accessproposals)
Methods
get GET /drive/v3/files/{fileId}/accessproposals/{proposalId}
(/workspace/drive/api/reference/rest/ Retrieves an AccessProposal by ID.
v3/accessproposals/get)
list GET /drive/v3/files/{fileId}/accessproposals
(/workspace/drive/api/reference/rest/ List the AccessProposals on a file.
v3/accessproposals/list)
resolve POST /drive/v3/files/{fileId}/accessproposals/{proposalId}:resolve
(/workspace/drive/api/reference/rest/ Used to approve or deny an Access Proposal.
v3/accessproposals/resolve)
REST Resource: v3.apps (/workspace/drive/api/reference/rest/v3/apps)
https://developers.google.com/workspace/drive/api/reference/rest/v3 2/11
7/17/25, 9:47 AM Google Drive API | Google for Developers
Methods
get GET /drive/v3/apps/{appId}
(/workspace/drive/api/reference/rest/ Gets a specific app.
v3/apps/get)
list GET /drive/v3/apps
(/workspace/drive/api/reference/rest/ Lists a user's installed apps.
v3/apps/list)
REST Resource: v3.changes (/workspace/drive/api/reference/rest/v3/changes)
Methods
getStartPageToken GET /drive/v3/changes/startPageToken
(/workspace/drive/api/reference/rest/ Gets the starting pageToken for listing future changes.
v3/changes/getStartPageToken)
list GET /drive/v3/changes
(/workspace/drive/api/reference/rest/ Lists the changes for a user or shared drive.
v3/changes/list)
watch POST /drive/v3/changes/watch
(/workspace/drive/api/reference/rest/ Subscribes to changes for a user.
v3/changes/watch)
https://developers.google.com/workspace/drive/api/reference/rest/v3 3/11
7/17/25, 9:47 AM Google Drive API | Google for Developers
REST Resource: v3.channels (/workspace/drive/api/reference/rest/v3/channels)
Methods
stop POST /drive/v3/channels/stop
(/workspace/drive/api/reference/rest/ Stops watching resources through this channel.
v3/channels/stop)
REST Resource: v3.comments (/workspace/drive/api/reference/rest/v3/comments)
Methods
create POST /drive/v3/files/{fileId}/comments
(/workspace/drive/api/reference/rest/ Creates a comment on a file.
v3/comments/create)
delete DELETE /drive/v3/files/{fileId}/comments/{commentId}
(/workspace/drive/api/reference/rest/ Deletes a comment.
v3/comments/delete)
get GET /drive/v3/files/{fileId}/comments/{commentId}
(/workspace/drive/api/reference/rest/ Gets a comment by ID.
v3/comments/get)
list GET /drive/v3/files/{fileId}/comments
(/workspace/drive/api/reference/rest/ Lists a file's comments.
v3/comments/list)
https://developers.google.com/workspace/drive/api/reference/rest/v3 4/11
7/17/25, 9:47 AM Google Drive API | Google for Developers
Methods
update PATCH /drive/v3/files/{fileId}/comments/{commentId}
(/workspace/drive/api/reference/rest/ Updates a comment with patch semantics.
v3/comments/update)
REST Resource: v3.drives (/workspace/drive/api/reference/rest/v3/drives)
Methods
create POST /drive/v3/drives
(/workspace/drive/api/reference/rest/ Creates a shared drive.
v3/drives/create)
delete DELETE /drive/v3/drives/{driveId}
(/workspace/drive/api/reference/rest/ Permanently deletes a shared drive for which the user is an organizer.
v3/drives/delete)
get GET /drive/v3/drives/{driveId}
(/workspace/drive/api/reference/rest/ Gets a shared drive's metadata by ID.
v3/drives/get)
hide POST /drive/v3/drives/{driveId}/hide
(/workspace/drive/api/reference/rest/ Hides a shared drive from the default view.
v3/drives/hide)
https://developers.google.com/workspace/drive/api/reference/rest/v3 5/11
7/17/25, 9:47 AM Google Drive API | Google for Developers
Methods
list GET /drive/v3/drives
(/workspace/drive/api/reference/rest/
v3/drives/list) Lists the user's shared drives.
unhide POST /drive/v3/drives/{driveId}/unhide
(/workspace/drive/api/reference/rest/ Restores a shared drive to the default view.
v3/drives/unhide)
update PATCH /drive/v3/drives/{driveId}
(/workspace/drive/api/reference/rest/ Updates the metadata for a shared drive.
v3/drives/update)
REST Resource: v3.files (/workspace/drive/api/reference/rest/v3/files)
Methods
copy POST /drive/v3/files/{fileId}/copy
(/workspace/drive/api/reference/rest/ Creates a copy of a file and applies any requested updates with patch semantics.
v3/files/copy)
create POST /drive/v3/files
(/workspace/drive/api/reference/rest/ POST /upload/drive/v3/files
v3/files/create)
Creates a new file.
https://developers.google.com/workspace/drive/api/reference/rest/v3 6/11
7/17/25, 9:47 AM Google Drive API | Google for Developers
Methods
delete DELETE /drive/v3/files/{fileId}
(/workspace/drive/api/reference/rest/ Permanently deletes a file owned by the user without moving it to the trash.
v3/files/delete)
download POST /drive/v3/files/{fileId}/download
(/workspace/drive/api/reference/rest/ Downloads content of a file.
v3/files/download)
emptyTrash DELETE /drive/v3/files/trash
(/workspace/drive/api/reference/rest/ Permanently deletes all of the user's trashed files.
v3/files/emptyTrash)
export GET /drive/v3/files/{fileId}/export
(/workspace/drive/api/reference/rest/ Exports a Google Workspace document to the requested MIME type and returns exported byte content.
v3/files/export)
generateIds GET /drive/v3/files/generateIds
(/workspace/drive/api/reference/rest/ Generates a set of file IDs which can be provided in create or copy requests.
v3/files/generateIds)
get GET /drive/v3/files/{fileId}
(/workspace/drive/api/reference/rest/
v3/files/get) Gets a file's metadata or content by ID.
list GET /drive/v3/files
(/workspace/drive/api/reference/rest/
v3/files/list) Lists the user's files.
https://developers.google.com/workspace/drive/api/reference/rest/v3 7/11
7/17/25, 9:47 AM Google Drive API | Google for Developers
Methods
listLabels GET /drive/v3/files/{fileId}/listLabels
(/workspace/drive/api/reference/rest/ Lists the labels on a file.
v3/files/listLabels)
modifyLabels POST /drive/v3/files/{fileId}/modifyLabels
(/workspace/drive/api/reference/rest/ Modifies the set of labels applied to a file.
v3/files/modifyLabels)
update PATCH /drive/v3/files/{fileId}
(/workspace/drive/api/reference/rest/ PATCH /upload/drive/v3/files/{fileId}
v3/files/update)
Updates a file's metadata and/or content.
watch POST /drive/v3/files/{fileId}/watch
(/workspace/drive/api/reference/rest/ Subscribes to changes to a file.
v3/files/watch)
REST Resource: v3.operations (/workspace/drive/api/reference/rest/v3/operations)
Methods
get GET /drive/v3/operations/{name}
(/workspace/drive/api/reference/rest/ Gets the latest state of a long-running operation.
v3/operations/get)
https://developers.google.com/workspace/drive/api/reference/rest/v3 8/11
7/17/25, 9:47 AM Google Drive API | Google for Developers
REST Resource: v3.permissions (/workspace/drive/api/reference/rest/v3/permissions)
Methods
create POST /drive/v3/files/{fileId}/permissions
(/workspace/drive/api/reference/rest/ Creates a permission for a file or shared drive.
v3/permissions/create)
delete DELETE /drive/v3/files/{fileId}/permissions/{permissionId}
(/workspace/drive/api/reference/rest/ Deletes a permission.
v3/permissions/delete)
get GET /drive/v3/files/{fileId}/permissions/{permissionId}
(/workspace/drive/api/reference/rest/ Gets a permission by ID.
v3/permissions/get)
list GET /drive/v3/files/{fileId}/permissions
(/workspace/drive/api/reference/rest/ Lists a file's or shared drive's permissions.
v3/permissions/list)
update PATCH /drive/v3/files/{fileId}/permissions/{permissionId}
(/workspace/drive/api/reference/rest/ Updates a permission with patch semantics.
v3/permissions/update)
REST Resource: v3.replies (/workspace/drive/api/reference/rest/v3/replies)
https://developers.google.com/workspace/drive/api/reference/rest/v3 9/11
7/17/25, 9:47 AM Google Drive API | Google for Developers
Methods
create POST /drive/v3/files/{fileId}/comments/{commentId}/replies
(/workspace/drive/api/reference/rest/ Creates a reply to a comment.
v3/replies/create)
delete DELETE /drive/v3/files/{fileId}/comments/{commentId}/replies/{replyId}
(/workspace/drive/api/reference/rest/ Deletes a reply.
v3/replies/delete)
get GET /drive/v3/files/{fileId}/comments/{commentId}/replies/{replyId}
(/workspace/drive/api/reference/rest/ Gets a reply by ID.
v3/replies/get)
list GET /drive/v3/files/{fileId}/comments/{commentId}/replies
(/workspace/drive/api/reference/rest/ Lists a comment's replies.
v3/replies/list)
update PATCH /drive/v3/files/{fileId}/comments/{commentId}/replies/{replyId}
(/workspace/drive/api/reference/rest/ Updates a reply with patch semantics.
v3/replies/update)
REST Resource: v3.revisions (/workspace/drive/api/reference/rest/v3/revisions)
https://developers.google.com/workspace/drive/api/reference/rest/v3 10/11
7/17/25, 9:47 AM Google Drive API | Google for Developers
Methods
delete DELETE /drive/v3/files/{fileId}/revisions/{revisionId}
(/workspace/drive/api/reference/rest/ Permanently deletes a file version.
v3/revisions/delete)
get GET /drive/v3/files/{fileId}/revisions/{revisionId}
(/workspace/drive/api/reference/rest/ Gets a revision's metadata or content by ID.
v3/revisions/get)
list GET /drive/v3/files/{fileId}/revisions
(/workspace/drive/api/reference/rest/ Lists a file's revisions.
v3/revisions/list)
update PATCH /drive/v3/files/{fileId}/revisions/{revisionId}
(/workspace/drive/api/reference/rest/ Updates a revision with patch semantics.
v3/revisions/update)
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License (https://creativecommons.org/licenses/by/4.0/),
and code samples are licensed under the Apache 2.0 License (https://www.apache.org/licenses/LICENSE-2.0). For details, see the Google Developers Site Policies
(https://developers.google.com/site-policies). Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-04-18 UTC.
https://developers.google.com/workspace/drive/api/reference/rest/v3 11/11
