名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Drive リソースは、ユーザーの OneDrive または SharePoint のドキュメント ライブラリを表す、最上位レベルのオブジェクトです。
OneDrive ユーザーには常に少なくとも 1 つのドライブ (既定のドライブ) を使用できます。 OneDrive のライセンスが付与されていないユーザーには、使用可能な既定のドライブがないことがあります。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| ドライブを一覧表示する | drive コレクション | ターゲット ユーザー、グループ、またはサイトで使用可能なドライブ リソースの一覧を取得します。 |
| ドライブを取得する | ドライブ | ドライブに関するメタデータを取得します。 |
| ドライブのルートを取得する | driveItem | ドライブのルート フォルダーを取得します。 |
| アクティビティを一覧表示する | itemActivity コレクション | ドライブ、リスト、アイテム、またはアイテム階層内で行われた最近のアクティビティを一覧表示します。 |
| フォローされたアイテムを一覧表示する | driveItem コレクション | ユーザーがフォローしている driveItems を一覧表示します。 |
| 子を一覧表示する | driveItem コレクション | ドライブのルート フォルダーの子を一覧表示します。 |
| 変更を一覧表示する | driveItem コレクション | ドライブ内のすべての driveItems の変更を一覧表示します。 |
| 検索 | driveItem コレクション | ドライブ内の driveItems を検索します。 |
| 特殊なフォルダーを取得する | driveItem | 特別なフォルダーに正規名でアクセスします。 |
| 最近 (非推奨) | driveItem コレクション | サインインしたユーザーが最近使用した項目のセットを一覧表示します。 |
| 自分と共有 (非推奨) | driveItem コレクション | ドライブの所有者と共有している driveItem オブジェクトのリストを取得します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| createdBy | identitySet | 項目を作成したユーザー、デバイス、またはアプリケーションの ID。 読み取り専用です。 |
| createdDateTime | dateTimeOffset | アイテム作成の日時。 読み取り専用です。 |
| 説明 | String | ユーザーに表示されるドライブの説明を提供します。 読み取り/書き込み。 |
| driveType | String | このリソースで表されるドライブの種類についての説明。 OneDrive 個人用ドライブは personalを返します。 OneDrive for Businessはbusinessを返します。 SharePoint ドキュメント ライブラリは documentLibrary を返します。 読み取り専用です。 |
| id | String | ドライブの一意識別子。 読み取り専用。 |
| lastModifiedBy | identitySet | アイテムを最後に変更したユーザー、デバイス、およびアプリケーションの ID。 読み取り専用です。 |
| lastModifiedDateTime | dateTimeOffset | アイテムが最後に変更された日時。 読み取り専用です。 |
| name | string | アイテムの名前。 読み取り/書き込み。 |
| owner | identitySet | 省略可能。 ドライブを所有しているユーザー アカウント。 読み取り専用です。 |
| quota | quota | 省略可能。 ドライブの記憶領域クォータに関する情報。 読み取り専用です。 |
| settings | driveSettings | ドライブに関連付けられている設定。 読み取り専用です。 このプロパティは既定では返されず、 $select クエリ パラメーターを使用して選択する必要があります。 |
| sharepointIds | sharepointIds | SharePoint REST 互換性に役立つ識別子を返します。 読み取り専用です。 このプロパティは既定では返されず、 $select クエリ パラメーターを使用して選択する必要があります。 |
| system | systemFacet | この値が設定されている場合は、システム管理ドライブであることを示します。 読み取り専用です。 |
| webUrl | string (URL) | ブラウザーでリソースを表示する URL。 読み取り専用です。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| アクティビティ | itemActivity コレクション | このドライブに対して行われた最近のアクティビティのリストです。 |
| バンドル | driveItem コレクション | バンドル のコレクション (アルバムとアイテムの複数選択共有セット)。 個人用 OneDrive でのみ。 |
| フォロー中 | driveItem コレクション | ユーザーがフォローしているアイテムの一覧。 OneDrive for Business のみ。 |
| items | driveItem コレクション | ドライブに含まれているすべてのアイテム。 読み取り専用。 Null 許容型。 |
| root | driveItem | ドライブのルート フォルダー。 読み取り専用。 |
| special | driveItem コレクション | OneDrive で使用可能な共通フォルダーのコレクション。 読み取り専用。 Null 許容型。 |
| list | list | SharePoint のドライブの場合は、基になるドキュメント ライブラリのリスト。 読み取り専用です。 Null 許容型。 |
JSON 表記
ドライブ リソースの JSON 表現を次に示します。
drive リソースは baseItem から派生しており、そのリソースからプロパティを継承しています。
{
"activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
"id": "string",
"createdBy": {"@odata.type": "microsoft.graph.identitySet"},
"createdDateTime": "string (timestamp)",
"description": "string",
"driveType": "personal | business | documentLibrary",
"following": [{"@odata.type": "microsoft.graph.driveItem"}],
"items": [{"@odata.type": "microsoft.graph.driveItem"}],
"lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
"lastModifiedDateTime": "string (timestamp)",
"name": "string",
"owner": {"@odata.type": "microsoft.graph.identitySet"},
"quota": {"@odata.type": "microsoft.graph.quota"},
"root": {"@odata.type": "microsoft.graph.driveItem"},
"settings": {"@odata.type": "microsoft.graph.driveSettings"},
"sharepointIds": {"@odata.type": "microsoft.graph.sharepointIds"},
"special": [{"@odata.type": "microsoft.graph.driveItem"}],
"system": {"@odata.type": "microsoft.graph.systemFacet"},
"webUrl": "string",
}