Method: apps.list
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
ユーザーのインストール済みアプリのリストを取得します。詳しくは、ユーザー情報を返すをご覧ください。
HTTP リクエスト
GET https://www.googleapis.com/drive/v3/apps
この URL は gRPC Transcoding 構文を使用します。
クエリ パラメータ
パラメータ |
appFilterExtensions |
string
返される結果を制限するファイル拡張子のカンマ区切りリスト。指定されたアプリ クエリ スコープ内のすべての結果のうち、指定されたファイル拡張子のいずれかを開くことができるものがレスポンスに含まれます。appFilterMimeTypes も指定されている場合、結果は 2 つのアプリリストの和集合になります。
|
appFilterMimeTypes |
string
返される結果を制限するファイル拡張子のカンマ区切りリスト。指定されたアプリ クエリ スコープ内の結果のうち、指定された MIME タイプのいずれかを開くことができるものはすべてレスポンスに含まれます。appFilterExtensions も指定されている場合、結果は 2 つのアプリリストの和集合になります。
|
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
一部のスコープは制限されており、アプリでそれらを使用するにはセキュリティ評価が必要です。詳しくは、承認ガイドをご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 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)."]]