Google Drive provides two options to gather information about Drive users:
Using the
about
resource, you can retrieve information about the user, the user's Drive settings, and their system capabilities.Using the
apps
resource, you can retrieve a list of the user's installed apps, with information about each app's supported MIME types, file extensions, and other details.
This guide explains how you can retrieve user info in Drive.
Fetch information about a user
To return information on a Drive user as an instance of
about
, use the
about.get
method. The about.get
method requires the fields
query parameter in your method call. The returned
values are measured in bytes. For more information, see Return specific fields
for a file.
Show an example
The following code sample shows how to provide multiple fields
as a query parameter in the request. The response returns the field values for the request.
Request
GET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota
Response
{ "kind": "drive#about", "user": { "kind": "drive#user", "displayName": "DISPLAY_NAME", "photoLink": "PHOTO_LINK", "me": true, "permissionId": "PERMISSION_ID", "emailAddress": "EMAIL_ADDRESS" }, "storageQuota": { "usage": "10845031958", "usageInDrive": "2222008387", "usageInDriveTrash": "91566" } }
The response includes the following values:
DISPLAY_NAME
: the user's name in plain text.PHOTO_LINK
: the URL of the user's profile photo.PERMISSION_ID
: the user's ID within thePermission
resources.EMAIL_ADDRESS
: the user's email address
Fetch information about a user's apps
Google Drive apps are listed in the Google Workspace Marketplace and are used to make Drive more convenient such as the Google Docs app or an add-on used within Docs to sign documents. For more information, see Use Google Drive apps.
To return a list of all the user's installed apps as an instance of
apps
, use the
apps.list
method without any
parameters.
Show an example
The following code sample shows how to return a list of all the user's installed apps in the request. The response returns the field values for the request.
Request
GET https://www.googleapis.com/drive/v3/apps
Response
{ "kind": "drive#appList", "selfLink": "https://www.googleapis.com/drive/v3/apps", "items": [ { "kind": "drive#app", "id": "ID", "name": "Google Sheets", "supportsCreate": true, "supportsImport": true, "supportsMultiOpen": false, "supportsOfflineCreate": true, "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap", "productId": "PRODUCT_ID" } ], "defaultAppIds": [ "ID" ] }
The response includes the following values:
ID
: the app ID.PRODUCT_ID
: the product listing ID for this app.
List user apps with query parameters
To find a specific app, use one or more of the optional query parameters:
appFilterExtensions
: Filter the search results using a comma-separated list of file extensions. Apps within the app query scope that can open the listed file extensions are included in the response. IfappFilterMimeTypes
are also provided, a union of the two resulting app lists is returned. Examples of extensions includedocx
for Microsoft Word andpptx
for Microsoft PowerPoint. For more examples of file extensions, see Export MIME types for Google Workspace documents.The following code sample shows how to provide multiple file extensions as a query parameter:
GET https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx
.appFilterMimeTypes
: Filter the search results using a comma-separated list of MIME types. Apps within the app query scope that can open the listed MIME types are included in the response. IfappFilterExtensions
are also provided, a union of the two resulting app lists is returned. Examples of MIME types includeapplication/vnd.google-apps.form
for Google Forms andapplication/vnd.google-apps.site
for Google Sites. For more examples of MIME types, see Google Workspace and Google Drive supported MIME types.The following code sample shows how to provide multiple MIME types as a query parameter:
GET https://www.googleapis.com/drive/v3/apps?appFilterMimeTypes=application/vnd.google-apps.form,application/vnd.google-apps.site
.languageCode
: Filter the search results using a language or locale code, as defined by BCP 47, with some extensions from Unicode's LDML format. Examples of language codes includeen-us
for English (United States) andfr-ca
for French (Canada).The following code sample shows how to provide multiple language codes as a query parameter:
GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca
.
Get user app by ID
To download the detailed app info as an instance of
apps
, use the
apps.get
method with the app ID.
Show an example
The following code sample shows how to provide an appId
as a query parameter in the request. The response returns the field values for the request.
Request
GET https://www.googleapis.com/drive/v3/apps/APP_ID
Response
{ "kind": "drive#app", "id": "ID", "name": "Google Sheets", "supportsCreate": true, "supportsImport": true, "supportsMultiOpen": false, "supportsOfflineCreate": true, "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap", "productId": "PRODUCT_ID" }
The response includes the following values:
ID
: the app ID.PRODUCT_ID
: the product listing ID for this app.
Related topics
Here are a few next steps you might try:
To create a file in Drive, see Create files.
To upload file data when you create or update a file, see Upload file data.
To download and export files, see Download and export files.