ドライブ リソースの種類

ドライブ リソースは、ユーザーの OneDrive または SharePoint のドキュメント ライブラリを表す、最上位のオブジェクトです。

OneDrive のユーザーは、少なくとも 1 つのドライブ (そのユーザーの既定のドライブ) を常に使用できます。OneDrive のライセンスが付与されていないユーザーには、使用可能な既定のドライブがないことがあります。

JSON 表記

以下は、リソースの JSON 表記です。

{
  "id": "string (identifier)",
  "driveType": "string",
  "owner": {"@odata.type": "microsoft.graph.identitySet"},
  "quota": {"@odata.type": "microsoft.graph.quota"},
  "root": {"@odata.type": "microsoft.graph.driveItem" },
  "items": [ {"@odata.type": "microsoft.graph.driveItem" }],
  "special": [ {"@odata.type": "microsoft.graph.driveItem" }]
}

プロパティ

プロパティ 説明
id String ドライブの一意識別子。読み取り専用。
driveType String このリソースで表されるドライブの種類についての説明。OneDrive 個人用のドライブは personal を返します。OneDrive for Business は business を返します。SharePoint ドキュメント ライブラリは documentLibrary を返します。読み取り専用。
owner identitySet 省略可能。ドライブを所有しているユーザー アカウント。
quota quota 省略可能。ドライブの記憶領域クォータに関する情報。

リレーションシップ

リレーションシップ 説明
items driveitem コレクション ドライブに含まれているすべてのアイテム。読み取り専用。Null 許容型。
root driveitem ドライブのルート フォルダー。読み取り専用。
special driveitem コレクション OneDrive で使用可能な共通フォルダーのコレクション。読み取り専用。Null 許容型。

メソッド

次に、ドライブ リソースで使用可能なメソッドを示します。

メソッド REST パス
ユーザーの既定のドライブの取得 GET /me/drive
別のユーザーのドライブの取得 GET /users/{user-id}/drive
ドライブのルート フォルダーの取得 GET /drives/{drive-id}/root
ドライブ内のアイテムの一覧 GET /me/drive/root/children
ドライブ内の変更内容の一覧 GET /me/drive/root/delta
ドライブ内のアイテムの検索 GET /me/drive/search(q='text')