Method: drives.list
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
ユーザーの共有ドライブを一覧表示します。
このメソッドには、1 つ以上の検索語句を組み合わせた検索クエリを q
パラメータとして渡すことができます。詳しくは、共有ドライブを検索するをご覧ください。
HTTP リクエスト
GET https://www.googleapis.com/drive/v3/drives
この URL は gRPC Transcoding 構文を使用します。
クエリ パラメータ
パラメータ |
pageSize |
integer
ページごとに返される共有ドライブの最大数。
|
pageToken |
string
共有ドライブのページトークン。
|
q |
string
共有ドライブを検索するためのクエリ文字列。
|
useDomainAdminAccess |
boolean
ドメイン管理者としてリクエストを発行します。true に設定すると、リクエスト元が管理者であるドメインのすべての共有ドライブが返されます。
|
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
共有ドライブのリスト。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
JSON 表現 |
{
"drives": [
{
object (Drive )
}
],
"nextPageToken": string,
"kind": string
} |
フィールド |
drives[] |
object (Drive )
共有ドライブのリスト。nextPageToken が入力されている場合、このリストは不完全である可能性があり、結果の追加ページを取得する必要があります。
|
nextPageToken |
string
共有ドライブの次のページのページトークン。リストの最後に達している場合、これは存在しません。なんらかの理由でトークンが拒否された場合は、トークンを破棄し、結果の最初のページからページネーションを再開する必要があります。通常、ページトークンは数時間有効です。ただし、新しいアイテムが追加または削除された場合は、予測される結果が異なる可能性があります。
|
kind |
string
リソースの種類を示します。値は固定文字列 "drive#driveList" です。
|
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.readonly
一部のスコープは制限されており、アプリでそれらを使用するにはセキュリティ評価が必要です。詳しくは、承認ガイドをご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[],[],null,["# Method: drives.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.DriveList.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\n\u003cbr /\u003e\n\nLists the user's shared drives.\n\nThis method accepts the `q` parameter, which is a search query combining one or more search terms. For more information, see the [Search for shared drives](/workspace/drive/api/guides/search-shareddrives) guide.\n\n### HTTP request\n\n`GET https://www.googleapis.com/drive/v3/drives`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Maximum number of shared drives to return per page. |\n| `pageToken` | `string` Page token for shared drives. |\n| `q` | `string` Query string for searching shared drives. |\n| `useDomainAdminAccess` | `boolean` Issue the request as a domain administrator; if set to true, then all shared drives of the domain in which the requester is an administrator are returned. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA list of shared drives.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"drives\": [ { object (/workspace/drive/api/reference/rest/v3/drives#Drive) } ], \"nextPageToken\": string, \"kind\": string } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `drives[]` | `object (`[Drive](/workspace/drive/api/reference/rest/v3/drives#Drive)`)` The list of shared drives. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched. |\n| `nextPageToken` | `string` The page token for the next page of shared drives. This will be absent if the end of the list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string `\"drive#driveList\"`. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.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)."]]