Google: Lists a user's installed apps For more information, see Return user info (https: developers google com workspace drive api guides user-info)

← Drive apps operations · Get started

Operation google.drive_apps_list

Provider route: GET /drive/v3/apps. Alter supplies the connection’s credentials and routing.

Call through Alter

Install @alter-ai/sdk @alter-ai/google with npm, or alter-sdk-google with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { GoogleIntegration } from "@alter-ai/google";

async function execute(input: Parameters<GoogleIntegration["driveApps"]["driveAppsList"]>[0]) {
  const app = new App({ apiKey: process.env.ALTER_API_KEY! });
  try {
    const provider = new GoogleIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
    const call = await provider.driveApps.driveAppsList(input);
    const result = await call.wait();
    return result.bodyJson();
  } finally {
    await app.close();
  }
}

import os
from alter_sdk import App
from alter_sdk_google import GoogleIntegration

async def execute(arguments):
    async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
        provider = GoogleIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
        call = await provider.drive_apps.drive_apps_list(arguments)
        result = await call.wait()
        return result.body_json()

Input

Field	Type	Presence	Description and constraints
$	object	Root	Additional keys: not allowed
query	object	Optional	Additional keys: not allowed
query.fields	string	Optional	Selector specifying which fields to include in a partial response.
query.prettyPrint	boolean	Optional	Returns response with indentations and line breaks. Default: true
query.quotaUser	string	Optional	Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
query.appFilterExtensions	string	Optional	A comma-separated list of file extensions to limit returned results. All results within the given app query scope which can open any of the given file extensions are included in the response. If `appFilterMimeTypes` are provided as well, the result is a union of the two resulting app lists. Default:
query.appFilterMimeTypes	string	Optional	A comma-separated list of file extensions to limit returned results. All results within the given app query scope which can open any of the given MIME types will be included in the response. If `appFilterExtensions` are provided as well, the result is a union of the two resulting app lists. Default:
query.languageCode	string	Optional	A language or locale code, as defined by BCP 47, with some extensions from Unicode’s LDML format (http://www.unicode.org/reports/tr35/).

Response

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

Field	Type	Presence	Description and constraints
$	Model	Root	Expand Lists a user’s installed apps For more information, see Return user info (https: developers google com workspace drive api guides user-info) — response body

Referenced models: Lists a user’s installed apps For more information, see Return user info (https: developers google com workspace drive api guides user-info) — response body

Schemas

Lists a user's installed apps For more information, see Return user info (https: developers google com workspace drive api guides user-info) — response body

Field	Type	Presence	Description and constraints
$	object	Root	A list of third-party applications which the user has installed or given access to Google Drive.
defaultAppIds	array	Optional	The list of app IDs that the user has specified to use by default. The list is in reverse-priority order (lowest to highest).
defaultAppIds[]	string	Each item
items	array	Optional	The list of apps.
items[]	Model	Each item	Expand Gets a specific app For more information, see Return user info (https: developers google com workspace drive api guides user-info) — response body
kind	string	Optional	Output only. Identifies what kind of resource this is. Value: the fixed string "drive#appList". Default: drive#appList
selfLink	string	Optional	A link back to this list.

Referenced models: Gets a specific app For more information, see Return user info (https: developers google com workspace drive api guides user-info) — response body

Gets a specific app For more information, see Return user info (https: developers google com workspace drive api guides user-info) — response body

Field	Type	Presence	Description and constraints
$	object	Root	The `apps` resource provides a list of 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.
authorized	boolean	Optional	Whether the app is authorized to access data on the user's Drive.
createInFolderTemplate	string	Optional	The template URL to create a file with this app in a given folder. The template contains the {folderId} to be replaced by the folder ID house the new file.
createUrl	string	Optional	The URL to create a file with this app.
hasDriveWideScope	boolean	Optional	Whether the app has Drive-wide scope. An app with Drive-wide scope can access all files in the user's Drive.
icons	array	Optional	The various icons for the app.
icons[]	Model	Each item	Expand Gets a specific app For more information, see Return user info (https: developers google com workspace drive api guides user-info) — response body — icons item
id	string	Optional	The ID of the app.
installed	boolean	Optional	Whether the app is installed.
kind	string	Optional	Output only. Identifies what kind of resource this is. Value: the fixed string "drive#app". Default: drive#app
longDescription	string	Optional	A long description of the app.
name	string	Optional	The name of the app.
objectType	string	Optional	The type of object this app creates such as a Chart. If empty, the app name should be used instead.
openUrlTemplate	string	Optional	The template URL for opening files with this app. The template contains {ids} or {exportIds} to be replaced by the actual file IDs. For more information, see Open Files for the full documentation.
primaryFileExtensions	array	Optional	The list of primary file extensions.
primaryFileExtensions[]	string	Each item
primaryMimeTypes	array	Optional	The list of primary MIME types.
primaryMimeTypes[]	string	Each item
productId	string	Optional	The ID of the product listing for this app.
productUrl	string	Optional	A link to the product listing for this app.
secondaryFileExtensions	array	Optional	The list of secondary file extensions.
secondaryFileExtensions[]	string	Each item
secondaryMimeTypes	array	Optional	The list of secondary MIME types.
secondaryMimeTypes[]	string	Each item
shortDescription	string	Optional	A short description of the app.
supportsCreate	boolean	Optional	Whether this app supports creating objects.
supportsImport	boolean	Optional	Whether this app supports importing from Google Docs.
supportsMultiOpen	boolean	Optional	Whether this app supports opening more than one file.
supportsOfflineCreate	boolean	Optional	Whether this app supports creating files when offline.
useByDefault	boolean	Optional	Whether the app is selected as the default handler for the types it supports.

Referenced models: Gets a specific app For more information, see Return user info (https: developers google com workspace drive api guides user-info) — response body — icons item

Gets a specific app For more information, see Return user info (https: developers google com workspace drive api guides user-info) — response body — icons item

Field	Type	Presence	Description and constraints
$	object	Root
category	string	Optional	Category of the icon. Allowed values are: * `application` - The icon for the application. * `document` - The icon for a file associated with the app. * `documentShared` - The icon for a shared file associated with the app.
iconUrl	string	Optional	URL for the icon.
size	JSON	Optional
size (anyOf 1)	integer	Alternative	Size of the icon. Represented as the maximum of the width and height. Format: int32
size (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Policy, approvals and errors

SDK function policy ID: google.drive_apps_list. Catalog operation: drive.apps.list. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Required provider scopes: ["https://www.googleapis.com/auth/drive.apps.readonly"]

Official provider source