Stay organized with collections Save and categorize content based on your preferences.
To display your app in Google Drive when a user creates or opens a file, you must first set up a Drive user interface (UI) integration. Configuration is also required to list your app in the Google Workspace Marketplace.
Enable the Drive APIBefore using Google APIs, you must turn them on in a Google Cloud project. You can turn on one or more APIs in a single Google Cloud project.
To get started integrating with the Google Drive UI, you must enable the Drive API. This gives you access to the API and the UI integration features.
In the Google Cloud console, enable the Google Drive API.
Upload one or more Application icons to display in a user's list of connected Drive apps and in the "Open with" context menu. Icons should be in PNG format with a transparent background. Icons can take up to 24 hours to appear in Drive.
Note: Document icons are deprecated. Your application icon appears next to shortcut and third-party shortcut files. A set of standard icons is used for other file types.To use Drive UI's "Open with" menu item, enter the URL to your app in the Open URL field. This URL is used by the "Open With" context menu.
localhost doesn't work.state query parameter is appended to this URL to pass data from the Drive UI to your app. For information on the contents of the state parameter, see The state parameter.(Optional) Enter default MIME types and file extensions in the Default MIME types and Default file extensions fields. Default MIME types and file extensions represent files your app is uniquely built to open. For example, your app might open a built-in format for layering and editing images. Only include standard media types and make sure they're free of typos and misspellings. If your app only opens shortcut or third-party shortcut files, you can leave MIME type blank.
(Optional) Enter secondary MIME types and file extensions in the Secondary MIME types and Secondary file extensions fields. Secondary MIME types and file extensions represent files your app can open, but are not specific to your app. For example, your app might be an image-editing app that opens PNG and JPG images. Only include standard media types and make sure they're free of typos and misspellings. If your app only opens shortcut or third-party shortcut files, you can leave MIME type blank.
Note: If a user installs multiple Drive apps that can open a file, the most-recently installed app is used until the user chooses another app.To use Drive UI's "New" button and have users create a file with your app, check the Creating files box. The New URL and optional Document name fields appear.
localhost doesn't work.state query parameter is appended to this URL to pass data from the Drive UI to your app. For information on the contents of the state parameter, see The state parameter.Enter a URL in the New URL field. This URL is used by the "New" button to redirect the user to your application.
Note: Leave the Document name field blank. This field is no longer used.(Optional) If you want your app to open Google Workspace-supported files, check the Importing box.
(Optional) If your app must manage files on shared drives, check the Shared drives support box. For further information on how to support shared drives in your app, see Implement shared drive support.
Click Submit.
drive.install scope
To allow apps to appear as an option in the "Open with" or the "New" menu, request the https://www.googleapis.com/auth/drive.install scope to integrate with the Drive UI. When requesting this scope, users receive a dialog similar to this:
For more information about scopes you can request for Drive apps, and how to request them, see API-specific authorization and authentication information.
Note: If you publish your Drive app to the Google Workspace Marketplace, users and domain administrators can search for and install the app directly from the Google Workspace Marketplace. Thestate parameter
By default, a state parameter is appended to both the Open URL and the New URL to pass data from the Drive UI to your app. This parameter contains a JSON-encoded string with template variables and data about the request to your app. The variables included depend on the type of URL used (Open URL or New URL):
{ids} A comma-separated list of file IDs being opened. Open URL {exportIds} A comma-separated list of file IDs being exported. Used only when opening Google Workspace files. Open URL {resourceKeys} A JSON dictionary of file IDs mapped to their respective resource keys. Open URL {folderId} The ID of the parent folder. New URL {folderResourceKey} The resource key of the parent folder. New URL {userId} The profile ID that identifies the user. Open URL and New URL {action} The action being performed. The value is open when using an Open URL or create when using a New URL. Open URL and New URL
The state parameter is URL-encoded, so your app must handle the escape characters and parse it as JSON. Apps can detect the create value in the state parameter to verify a request to create a file.
The state information for a New URL is:
{
"action":"create",
"folderId":"FOLDER_ID",
"folderResourceKey":"FOLDER_RESOURCE_KEY",
"userId":"USER_ID"
}
The state information for an Open URL is:
{
"ids": ["ID"],
"resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
"action":"open",
"userId":"USER_ID"
}
The IDs and resource keys are used to fetch file metadata and download file content. Once your app has the file ID and an access token, it can check permissions, fetch the file metadata, and download the file content as described in the files.get method.
files.get method to check the user's permissions for a document. Apps should warn read-only users when they're opening a file they cannot edit or save (instead of letting them spend time editing, and then displaying an error on save).
An installed app must be able to create, manage, and open actions launched from the Drive UI. To learn more, see Integrate with Drive UI's "New" button or Integrate with Drive UI's "Open with" context menu.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-13 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-13 UTC."],[],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4