DriveItem リソース型
driveItem リソースは、ドライブに格納されているファイル、フォルダーなどのアイテムを表します。 OneDrive および SharePoint 内のすべてのファイル システム オブジェクトが、driveItem リソースとして返されます。
driveItem リソースのアドレス指定には、主に 2 つの方法があります。
drive/items/{item-id}を使用した、driveItem 一意識別子による方法/drive/root:/path/to/fileを使用した、ファイル システム パスによる方法
DriveItem リソースには、driveItem の ID と機能に関するデータを提供するプロパティとしてモデル化されたファセットがあります。 以下に例を示します。
- フォルダーにはフォルダー ファセットがあります
- ファイルには ファイル ファセットがあります。
- イメージには、ファイル ファセットに加えて イメージ ファセットがあります。
- カメラで撮影した画像 (写真) には写真ファセットがあります。写真ファセットは、アイテムを写真として識別し、撮影日時と撮影デバイスのプロパティを提供します。
フォルダー ファセットを持つアイテムは、アイテムのコンテナーとして機能するため、フォルダーに含まれる driveItems のコレクションを指す children 参照を持ちます。
JSON 表記
以下は、driveItem リソースの JSON 表記です。
driveItem リソースは baseItem から派生し、そのリソースからプロパティを継承します。
{
"audio": { "@odata.type": "microsoft.graph.audio" },
"content": { "@odata.type": "Edm.Stream" },
"cTag": "string (etag)",
"deleted": { "@odata.type": "microsoft.graph.deleted"},
"description": "string",
"file": { "@odata.type": "microsoft.graph.file" },
"fileSystemInfo": { "@odata.type": "microsoft.graph.fileSystemInfo" },
"folder": { "@odata.type": "microsoft.graph.folder" },
"image": { "@odata.type": "microsoft.graph.image" },
"location": { "@odata.type": "microsoft.graph.geoCoordinates" },
"malware": { "@odata.type": "microsoft.graph.malware" },
"package": { "@odata.type": "microsoft.graph.package" },
"photo": { "@odata.type": "microsoft.graph.photo" },
"publication": {"@odata.type": "microsoft.graph.publicationFacet"},
"remoteItem": { "@odata.type": "microsoft.graph.remoteItem" },
"root": { "@odata.type": "microsoft.graph.root" },
"searchResult": { "@odata.type": "microsoft.graph.searchResult" },
"shared": { "@odata.type": "microsoft.graph.shared" },
"sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
"size": 1024,
"specialFolder": { "@odata.type": "microsoft.graph.specialFolder" },
"video": { "@odata.type": "microsoft.graph.video" },
"webDavUrl": "string",
/* relationships */
"activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
"children": [{ "@odata.type": "microsoft.graph.driveItem" }],
"permissions": [ {"@odata.type": "microsoft.graph.permission"} ],
"thumbnails": [ {"@odata.type": "microsoft.graph.thumbnailSet"}],
"versions": [ {"@odata.type": "microsoft.graph.driveItemVersion"}],
/* inherited from baseItem */
"id": "string (identifier)",
"createdBy": {"@odata.type": "microsoft.graph.identitySet"},
"createdDateTime": "String (timestamp)",
"eTag": "string",
"lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
"lastModifiedDateTime": "String (timestamp)",
"name": "string",
"parentReference": {"@odata.type": "microsoft.graph.itemReference"},
"webUrl": "string",
/* instance annotations */
"@microsoft.graph.conflictBehavior": "string",
"@microsoft.graph.downloadUrl": "url",
"@microsoft.graph.sourceUrl": "url"
}
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| audio | audio | オーディオのメタデータ (アイテムがオーディオ ファイルである場合)。 読み取り専用です。 |
| content | Stream | コンテンツのストリーム (アイテムがファイルを表す場合)。 |
| createdBy | identitySet | そのアイテムを作成したユーザーの ID、デバイス、アプリケーション。 読み取り専用です。 |
| createdDateTime | DateTimeOffset | アイテム作成の日時。 読み取り専用です。 |
| cTag | String | アイテムのコンテンツの eTag。 メタデータのみが変更された場合、この eTag は変更されません。 メモ アイテムがフォルダーの場合、このプロパティは返されません。 読み取り専用です。 |
| deleted | deleted | アイテムの削除状態に関する情報。 読み取り専用です。 |
| 説明 | String | ユーザーに表示されるアイテムの説明を提供します。 読み取り/書き込み。 OneDrive Personal でのみ |
| eTag | String | アイテム全体 (メタデータおよびコンテンツ) の eTag。 読み取り専用です。 |
| file | file | ファイルのメタデータ (アイテムがファイルである場合)。 読み取り専用です。 |
| fileSystemInfo | fileSystemInfo | クライアント上のファイル システム情報。 読み取り/書き込み。 |
| folder | folder | フォルダーのメタデータ (アイテムがフォルダーである場合)。 読み取り専用です。 |
| id | String | ドライブ内のアイテムの一意識別子。 読み取り専用です。 |
| image | image | 画像のメタデータ (アイテムが画像である場合)。 読み取り専用です。 |
| lastModifiedBy | identitySet | アイテムを最終更新したユーザーの ID、デバイス、アプリケーション。 読み取り専用です。 |
| lastModifiedDateTime | DateTimeOffset | アイテムが最後に変更された日時。 読み取り専用です。 |
| location | geoCoordinates | 場所のメタデータ (アイテムに場所データが含まれている場合)。 読み取り専用です。 |
| マルウェア | マルウェア | アイテムにマルウェアが含まれていることが検出された場合のマルウェア メタデータ。 読み取り専用。 |
| name | String | アイテムの名前 (ファイル名と拡張子)。 読み取り/書き込み。 |
| package | package | これがある場合、アイテムはフォルダーやファイルではなく、パッケージです。 パッケージは、コンテキスト次第で、ファイルとして、あるいはフォルダーとして扱われます。 読み取り専用です。 |
| parentReference | itemReference | 親の情報 (アイテムに親がある場合)。 読み取り/書き込み。 |
| 写真 | photo | 写真のメタデータ (アイテムが写真である場合)。 読み取り専用です。 |
| publication | publicationFacet | アイテムが公開されているか、チェックアウトの状態かどうかの情報を、そのような操作をサポートする場所で提供します。 既定では、このプロパティは返されません。 読み取り専用です。 |
| remoteItem | remoteItem | リモート アイテムのデータ (現在アクセス中のドライブ以外のドライブから共有されているアイテムの場合)。 読み取り専用です。 |
| root | root | このプロパティが null ではない場合は、driveItem がドライブで最上位の driveItem であることを示します。 |
| searchResult | searchResult | 検索のメタデータ (検索結果に由来するアイテムの場合)。 読み取り専用です。 |
| shared | shared | アイテムが他のユーザーと共有されていることを示し、アイテムの共有状態に関する情報を提供します。 読み取り専用。 |
| sharepointIds | sharepointIds | SharePoint REST 互換性に役立つ識別子を返します。 読み取り専用です。 |
| size | Int64 | アイテムのサイズ (バイト単位)。 読み取り専用です。 |
| specialFolder | specialFolder | 現在のアイテムが特別なフォルダーとしても使用可能な場合は、このファセットが返されます。 読み取り専用です。 |
| video | video | ビデオのメタデータ (アイテムがビデオである場合)。 読み取り専用です。 |
| webDavUrl | String | アイテムの WebDAV 互換性のある URL。 |
| webUrl | String | ブラウザーでリソースを表示するための URL。 読み取り専用です。 |
注: eTag プロパティと cTag プロパティは、コンテナー (フォルダー) 上での機能が異なります。 cTag 値は、フォルダーのいずれかの子孫のコンテンツまたはメタデータが変更されると変更されます。 eTag 値は、子孫から派生したプロパティ (childCount や lastModifiedDateTime など) 以外のフォルダーのプロパティが変更されたときにのみ、変更されます。
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| アクティビティ | itemActivity コレクション | このアイテムに対して行われた最近のアクティビティのリストです。 |
| children | driveItem コレクション | アイテムの直接の子のアイテム オブジェクトを格納するコレクション。 子が含まれるのは、フォルダーを表すアイテムのみです。 読み取り専用です。 Null 許容型。 |
| listItem | listItem | SharePoint のドライブの場合は、関連付けられているドキュメント ライブラリのリスト アイテム。 読み取り専用です。 Null 許容型。 |
| アクセス許可 | permission コレクション | アイテムのアクセス許可のセット。 読み取り専用です。 Null 許容型。 |
| thumbnails | thumbnailSet コレクション | アイテムに関連付けられた ThumbnailSet オブジェクトを格納するコレクション。 詳細については、サムネイルの取得についてのページを参照してください。 読み取り専用です。 Null 許容型。 |
| versions | driveItemVersion コレクション | アイテムの以前のバージョンのリスト。 詳細については、「バージョンの一覧表示」を参照してください。 読み取り専用です。 Null 許容型。 |
インスタンスの属性
インスタンスの属性は、動作が特殊なプロパティです。 これらのプロパティは一時的なものであり、a) サービスの動作を定義するか、b) 短期的なプロパティの値 (有効期限を持つアイテムのダウンロード URL など) を提供します。
| プロパティ名 | 種類 | 説明 |
|---|---|---|
| @microsoft.graph.conflictBehavior | string | 新しいアイテムを作成するアクションの競合を解決する動作。 使用できる値は fail、replace、または rename です。 PUT の既定値は replace です。 この注釈とともにアイテムが返されることはありません。 書き込み専用です。 |
| @microsoft.graph.downloadUrl | string | このファイルのコンテンツをダウンロードするために使用できる URL。 この URL では認証は必要ありません。 読み取り専用です。 |
| @microsoft.graph.sourceUrl | 文字列 | PUT 要求を発行するときにこのインスタンスの注釈を使用すると、サービスに対し、URL のコンテンツをダウンロードし、それをファイルとして保存するように指示できます。 書き込み専用です。 |
メモ： 値は @microsoft.graph.downloadUrl 有効期間の短い URL であり、キャッシュできません。 URL は短い期間 (1 時間) だけ使用でき、その後は無効になります。
メソッド
| Method | REST パス |
|---|---|
| アイテムを取得する | GET /drive/items/{item-id} |
| アクティビティを一覧表示する | GET /drive/items/{item-id}/activities |
| 子を一覧表示する | GET /drive/items/{item-id}/children |
| バージョンを一覧表示する | GET /drive/items/{item-id}/versions |
| アイテムを作成する | POST /drive/items/{item-id}/children |
| アイテムを更新する | PATCH /drive/items/{item-id} |
| コンテンツをアップロードする | PUT /drive/items/{item-id}/content |
| コンテンツをダウンロードする | GET /drive/items/{item-id}/content |
| 特定のファイル形式をダウンロードする | GET /drive/items/{item-id}/content?format={format} |
| アイテムを削除する | DELETE /drive/items/{item-id} |
| アイテムを移動する | PATCH /drive/items/{item-id} |
| アイテムをコピーする | POST /drive/items/{item-id}/copy |
| アイテムを検索する | GET /drive/items/{item-id}/search(q='text') |
| ドライブ内の変更内容を一覧表示する | GET /drive/root/delta |
| サムネイルを一覧表示する | GET /drive/items/{item-id}/thumbnails |
| 共有リンクを作成する | POST /drive/items/{item-id}/createLink |
| アクセス許可を追加する | POST /drive/items/{item-id}/invite |
| アクセス許可を一覧表示する | GET /drive/items/{item-id}/permissions |
| アクセス許可を削除する | DELETE /drive/items/{item-id}/permissions/{perm-id} |
| アイテムをプレビューする | POST /drive/items/{item-id}/preview |
注釈
OneDrive for Business または SharePoint のドキュメント ライブラリでは、driveItem にフォルダー ファセットがある場合、cTag プロパティは返されません。