REST Resource: apps

Resource: App

The apps resource provides a list of the apps that a user has installed, with information about each app's supported MIME types, file extensions, and other details.

Some resource methods (such as apps.get) require an appId. Use the apps.list method to retrieve the ID for an installed application.

JSON representation
{
  "name": string,
  "objectType": string,
  "supportsCreate": boolean,
  "productUrl": string,
  "primaryMimeTypes": [
    string
  ],
  "secondaryMimeTypes": [
    string
  ],
  "primaryFileExtensions": [
    string
  ],
  "secondaryFileExtensions": [
    string
  ],
  "id": string,
  "supportsImport": boolean,
  "installed": boolean,
  "authorized": boolean,
  "icons": [
    {
      "size": integer,
      "category": string,
      "iconUrl": string
    }
  ],
  "useByDefault": boolean,
  "kind": string,
  "shortDescription": string,
  "longDescription": string,
  "supportsMultiOpen": boolean,
  "productId": string,
  "openUrlTemplate": string,
  "createUrl": string,
  "createInFolderTemplate": string,
  "supportsOfflineCreate": boolean,
  "hasDriveWideScope": boolean
}
Fields
name

string

The name of the app.

objectType

string

The type of object this app creates (e.g. Chart). If empty, the app name should be used instead.

supportsCreate

boolean

Whether this app supports creating new objects.

productUrl

string

A link to the product listing for this app.

primaryMimeTypes[]

string

The list of primary mime types.

secondaryMimeTypes[]

string

The list of secondary mime types.

primaryFileExtensions[]

string

The list of primary file extensions.

secondaryFileExtensions[]

string

The list of secondary file extensions.

id

string

The ID of the app.

supportsImport

boolean

Whether this app supports importing from Docs Editors.

installed

boolean

Whether the app is installed.

authorized

boolean

Whether the app is authorized to access data on the user's Drive.

icons[]

object

The various icons for the app.

icons[].size

integer

Size of the icon. Represented as the maximum of the width and height.

icons[].category

string

Category of the icon. Allowed values are:

  • application - icon for the application
  • document - icon for a file associated with the app
  • documentShared - icon for a shared file associated with the app
icons[].iconUrl

string

URL for the icon.

useByDefault

boolean

Whether the app is selected as the default handler for the types it supports.

kind

string

This is always drive#app.

shortDescription

string

A short description of the app.

longDescription

string

A long description of the app.

supportsMultiOpen

boolean

Whether this app supports opening more than one file.

productId

string

The ID of the product listing for this app.

openUrlTemplate

string

The template url for opening files with this app. The template will contain {ids} and/or {exportIds} to be replaced by the actual file ids. See Open Files for the full documentation.

createUrl

string

The url to create a new file with this app.

createInFolderTemplate

string

The template url to create a new file with this app in a given folder. The template will contain {folderId} to be replaced by the folder to create the new file in.

supportsOfflineCreate

boolean

Whether this app supports creating new files when offline.

hasDriveWideScope

boolean

Whether the app has drive-wide scope. An app with drive-wide scope can access all files in the user's drive.

Methods

get

Gets a specific app.

list

Lists a user's installed apps.