Method: apps.list
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Solicitação HTTP
GET https://www.googleapis.com/drive/v3/apps
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de consulta
Parâmetros |
appFilterExtensions |
string
Uma lista separada por vírgulas de extensões de arquivo para limitar os resultados retornados. Todos os resultados no escopo de consulta do app que podem abrir qualquer uma das extensões de arquivo fornecidas são incluídos na resposta. Se appFilterMimeTypes também forem fornecidos, o resultado será uma união das duas listas de apps.
|
appFilterMimeTypes |
string
Uma lista separada por vírgulas de extensões de arquivo para limitar os resultados retornados. Todos os resultados no escopo da consulta de app que podem abrir qualquer um dos tipos MIME especificados serão incluídos na resposta. Se appFilterExtensions também forem fornecidos, o resultado será uma união das duas listas de apps.
|
languageCode |
string
Um código de idioma ou localidade, conforme definido pelo BCP 47, com algumas extensões do formato LDML do Unicode (http://www.unicode.org/reports/tr35/).
|
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Uma lista de aplicativos de terceiros que o usuário instalou ou a que deu acesso ao Google Drive.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Representação JSON |
{
"defaultAppIds": [
string
],
"items": [
{
object (App )
}
],
"kind": string,
"selfLink": string
} |
Campos |
defaultAppIds[] |
string
A lista de IDs de apps que o usuário especificou para usar por padrão. A lista está em ordem de prioridade inversa (da mais baixa para a mais alta).
|
items[] |
object (App )
A lista de apps.
|
kind |
string
Apenas saída. Identifica o tipo de recurso. Valor: a string fixa "drive#appList".
|
selfLink |
string
Um link de volta para esta lista.
|
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/drive.apps.readonly
Alguns escopos são restritos e exigem uma avaliação de segurança para que o app possa usá-los. Para mais informações, consulte o guia de autorização.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 2025-07-25 UTC."],[],[],null,["# Method: apps.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.AppList.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists a user's installed apps. For more information, see [Return user info](https://developers.google.com/workspace/drive/api/guides/user-info).\n\n### HTTP request\n\n`GET https://www.googleapis.com/drive/v3/apps`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `appFilterExtensions` | `string` 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. |\n| `appFilterMimeTypes` | `string` 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. |\n| `languageCode` | `string` A language or locale code, as defined by BCP 47, with some extensions from Unicode's LDML format (\u003chttp://www.unicode.org/reports/tr35/)\u003e. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA list of third-party applications which the user has installed or given access to Google Drive.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"defaultAppIds\": [ string ], \"items\": [ { object (/workspace/drive/api/reference/rest/v3/apps#App) } ], \"kind\": string, \"selfLink\": string } ``` |\n\n| Fields ||\n|-------------------|----------------------------------------------------------------------------------------------------------------------------------------|\n| `defaultAppIds[]` | `string` The list of app IDs that the user has specified to use by default. The list is in reverse-priority order (lowest to highest). |\n| `items[]` | `object (`[App](/workspace/drive/api/reference/rest/v3/apps#App)`)` The list of apps. |\n| `kind` | `string` Output only. Identifies what kind of resource this is. Value: the fixed string \"drive#appList\". |\n| `selfLink` | `string` A link back to this list. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/drive.apps.readonly`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]