Drive リソース型
ドライブ リソースは、ユーザーの OneDrive または SharePoint のドキュメント ライブラリを表す、最上位のオブジェクトです。
OneDrive のユーザーは、少なくとも 1 つのドライブ (そのユーザーの既定のドライブ) を常に使用できます。 OneDrive のライセンスが付与されていないユーザーには、使用可能な既定のドライブがないことがあります。
JSON 表記
Drive リソースの 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",
"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": "url"
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| 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 互換性に役立つ識別子を返します。 読み取り専用です。 |
| system | systemFacet | 存在する場合は、これがシステム管理のドライブであることを示しています。 読み取り専用です。 |
| webUrl | string (URL) | ブラウザーでリソースを表示する URL。 読み取り専用です。 |
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| アクティビティ | itemActivity コレクション | このドライブに対して行われた最近のアクティビティのリストです。 |
| items | DriveItem コレクション | ドライブに含まれているすべてのアイテム。 読み取り専用。 Null 許容型。 |
| root | DriveItem | ドライブのルート フォルダー。 読み取り専用。 |
| special | DriveItem コレクション | OneDrive で使用可能な共通フォルダーのコレクション。 読み取り専用。 Null 許容型。 |
| list | List | SharePoint のドライブの場合は、基になるドキュメント ライブラリのリスト。 読み取り専用です。 Null 許容型。 |
メソッド
| 共通タスク | HTTP メソッド |
|---|---|
| 別の Drive の Drive メタデータを取得する | GET /drives/{drive-id} |
| ユーザーの既定のドライブのルート フォルダーを取得する | GET /drive/root |
| ドライブのアクティビティを一覧表示する | GET /drive/activities |
| ドライブの子を一覧表示する | GET /drive/root/children |
| ドライブ内のすべてのアイテムの変更を一覧表示する | GET /drive/root/delta |
| ドライブ内のアイテムを検索する | GET /drive/root/search |
| 特殊フォルダーにアクセスする | GET /drive/special/{name} |
前の表では例に /drive を使用していますが、他のパスも有効です。