Method: apps.list
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
GET https://www.googleapis.com/drive/v3/apps
這個網址使用 gRPC 轉碼語法。
查詢參數
參數 |
appFilterExtensions |
string
以半形逗號分隔的副檔名清單,可限制傳回的結果。回應中會包含指定應用程式查詢範圍內的所有結果,這些結果可開啟任何指定副檔名。如果也提供 appFilterMimeTypes ,結果會是兩個應用程式清單的聯集。
|
appFilterMimeTypes |
string
以半形逗號分隔的副檔名清單,可限制傳回的結果。回應中會包含指定應用程式查詢範圍內的所有結果,這些結果可開啟任何指定的 MIME 類型。如果也提供 appFilterExtensions ,結果會是兩個應用程式清單的聯集。
|
languageCode |
string
BCP 47 定義的語言或地區代碼,並包含 Unicode LDML 格式 (http://www.unicode.org/reports/tr35/) 的部分擴充功能。
|
回應主體
使用者已安裝或授權存取 Google 雲端硬碟的第三方應用程式清單。
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
{
"defaultAppIds": [
string
],
"items": [
{
object (App )
}
],
"kind": string,
"selfLink": string
} |
欄位 |
defaultAppIds[] |
string
使用者指定預設使用的應用程式 ID 清單。清單會依優先順序由低至高排序。
|
items[] |
object (App )
應用程式清單。
|
kind |
string
僅供輸出。表示資源的種類。值:固定字串「drive#appList」。
|
selfLink |
string
返回這份清單的連結。
|
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/drive.apps.readonly
部分範圍受到限制,應用程式必須通過安全性評估才能使用。詳情請參閱授權指南。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[],[],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)."]]