Drive リソース型
名前空間: 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 | 正規名で特別なフォルダーにアクセスします。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| 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 | 省略可能。 ドライブの記憶領域クォータに関する情報。 読み取り専用です。 |
| 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"},
"sharepointIds": {"@odata.type": "microsoft.graph.sharepointIds"},
"special": [{"@odata.type": "microsoft.graph.driveItem"}],
"system": {"@odata.type": "microsoft.graph.systemFacet"},
"webUrl": "string",
}