DriveItem リソース型
名前空間: microsoft.graph
重要
Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。
driveItem リソースは、ドライブに格納されているファイル、フォルダーなどのアイテムを表します。
OneDrive および SharePoint 内のすべてのファイル システム オブジェクトが、driveItem リソースとして返されます。 SharePoint のドキュメント ライブラリにあるアイテムは、[llistItem][]または driveItem リソースとして表すことができます。
driveItem リソースのアドレス指定には、主に 2 つの方法があります。
drive/items/{item-id}を使用した、driveItem 一意識別子による方法/drive/root:/path/to/fileを使用した、ファイル システム パスによる方法
詳細については、「driveItems のアドレス指定」を参照してください。
DriveItem リソースには、driveItem の ID および機能に関するデータを提供するプロパティとしてモデル化されたファセットがあります。例:
- フォルダーには、フォルダー ファセット があります。
- ファイルには、ファイル ファセット があります。
- 画像には 画像ファセット とそのファイル ファセットがあります。
- カメラで撮影した画像 (写真) には 写真ファセット があります。写真ファセットは、アイテムを写真として識別し、撮影日時と撮影デバイスのプロパティを提供します。
フォルダー ファセットを持つアイテムは、アイテムのコンテナーとして機能するため、フォルダーに含まれる driveItems のコレクションを指す children 参照を持ちます。
注: OneDrive for Business または SharePoint のドキュメント ライブラリでは、driveItem に [フォルダー][] ファセットがある場合、cTag プロパティは返されません。
メソッド
| メソッド | REST パス |
|---|---|
| アイテムを取得する | GET /drive/items/{item-id} |
| アクティビティを一覧表示する | GET /drive/items/{item-id}/activities |
| 分析を取得する | GET /drive/items/{item-id}/analytics |
| 間隔によりアクティビティを取得する | GET /drive/items/{item-id}/getActivitiesByInterval |
| 子を一覧表示する | 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} |
| アイテムを復元する | POST /drive/items/{item-id}/restore |
| アイテムを移動する | PATCH /drive/items/{item-id} |
| アイテムをコピーする | POST /drive/items/{item-id}/copy |
| アイテムを検索する | GET /drive/items/{item-id}/search(q='text') |
| ドライブ内の変更内容を一覧表示する | GET /drive/root/delta |
| アイテムをフォローする | POST /drives/{drive-id}/items/{item-id}/follow |
| アイテムのフォローを解除する | POST /drives/{drive-id}/items/{item-id}/unfollow |
| サムネイルを一覧表示する | 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} |
| WebSocket チャネルを取得する | GET /drive/root/subscriptions/socketIo |
| アイテムをプレビューする | POST /drive/items/{item-id}/preview |
| チェックイン | POST /drives/{driveId}/items/{itemId}/checkin |
| チェックアウト | POST /drives/{driveId}/items/{itemId}/checkout |
| 許可を取り消す | PATCH /drive/items/{item-id}/permissions/{perm-id}/revokeGrants |
| 秘密度ラベルを抽出する | POST /drive/items/{item-id}/extractSensitivityLabels |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| audio | audio | オーディオのメタデータ (アイテムがオーディオ ファイルである場合)。 読み取り専用です。 OneDrive 個人用においてのみ。 |
| バンドル | バンドル | バンドル メタデータ (アイテムがバンドルである場合)。 読み取り専用です。 |
| content | Stream | コンテンツのストリーム (アイテムがファイルを表す場合)。 |
| createdBy | identitySet | そのアイテムを作成したユーザーの ID、デバイス、アプリケーション。読み取り専用です。 |
| createdDateTime | DateTimeOffset | アイテム作成の日時。読み取り専用です。 |
| cTag | String | アイテムのコンテンツの eTag。メタデータのみが変更された場合、この eTag は変更されません。注: アイテムがフォルダーである場合、このプロパティは返されません。読み取り専用です。 |
| deleted | deleted | アイテムの削除状態に関する情報。読み取り専用です。 |
| description | String | ユーザーに表示されるアイテムの説明を提供します。読み取り/書き込み。OneDrive 個人用においてのみ。 |
| eTag | String | アイテム全体 (メタデータおよびコンテンツ) の eTag。読み取り専用です。 |
| file | file | ファイルのメタデータ (アイテムがファイルである場合)。読み取り専用です。 |
| fileSystemInfo | fileSystemInfo | クライアント上のファイル システム情報。読み取り/書き込み。 |
| folder | [フォルダー][] | フォルダーのメタデータ (アイテムがフォルダーである場合)。読み取り専用です。 |
| id | String | ドライブ内のアイテムの一意識別子。読み取り専用です。 |
| image | image | 画像のメタデータ (アイテムが画像である場合)。読み取り専用です。 |
| lastModifiedBy | identitySet | アイテムを最終更新したユーザーの ID、デバイス、アプリケーション。読み取り専用です。 |
| lastModifiedDateTime | DateTimeOffset | アイテムが最後に変更された日時。 読み取り専用です。 |
| location | geoCoordinates | 場所のメタデータ (アイテムに場所データが含まれている場合)。読み取り専用です。 |
| マルウェア | マルウェア | アイテムにマルウェアが含まれていることが検出された場合のマルウェア メタデータ。読み取り専用です。 |
| メディア | media | メディア (オーディオまたはビデオ) 項目に関する情報。 読み取り/書き込み。 OneDrive for Business と SharePoint でのみ。 |
| name | String | アイテムの名前 (ファイル名と拡張子)。読み取り/書き込み。 |
| package | package | これがある場合、アイテムはフォルダーやファイルではなく、パッケージです。パッケージは、コンテキスト次第で、ファイルとして、あるいはフォルダーとして扱われます。読み取り専用です。 |
| parentReference | itemReference | 親の情報 (アイテムに親がある場合)。読み取り/書き込み。 |
| pendingOperations | pendingOperations | 存在する場合は、driveItem の状態に影響を与える可能性のある 1 つ以上の操作が完了待ちであることを示します。 読み取り専用です。 |
| photo | photo | 写真のメタデータ (アイテムが写真である場合)。読み取り専用です。 |
| publication | publicationFacet | アイテムが公開されているか、チェックアウトの状態かどうかの情報を、そのような操作をサポートする場所で提供します。 既定では、このプロパティは返されません。 読み取り専用です。 |
| remoteItem | remoteItem | リモート アイテムのデータ (現在アクセス中のドライブ以外のドライブから共有されているアイテムの場合)。読み取り専用です。 |
| root | root | このプロパティが null ではない場合は、driveItem がドライブで最上位の driveItem であることを示します。 |
| searchResult | searchResult | 検索のメタデータ (検索結果に由来するアイテムの場合)。読み取り専用です。 |
| 共有 | shared | アイテムが他のユーザーと共有されていることを示し、アイテムの共有状態に関する情報を提供します。読み取り専用です。 |
| sharepointIds | sharepointIds | SharePoint REST 互換性に役立つ識別子を返します。読み取り専用です。 |
| size | Int64 | アイテムのサイズ (バイト単位)。読み取り専用です。 |
| specialFolder | specialFolder | 現在のアイテムが特別なフォルダーとしても使用可能な場合は、このファセットが返されます。読み取り専用です。 |
| source | driveItemSource | ドライブ項目のソースに関する情報。 読み取り専用です。 OneDrive for Business と SharePoint でのみ。 |
| video | [video][] | ビデオのメタデータ (アイテムがビデオである場合)。読み取り専用です。 |
| webDavUrl | String | アイテムの WebDAV 互換性のある URL。 |
| webUrl | String | ブラウザーでリソースを表示するための URL。読み取り専用です。 |
注: eTag プロパティと cTag プロパティは、コンテナー (フォルダー) 上での機能が異なります。cTag 値は、フォルダーのいずれかの子孫のコンテンツまたはメタデータが変更されると変更されます。eTag 値は、子孫から派生したプロパティ (childCount や lastModifiedDateTime など) 以外のフォルダーのプロパティが変更されたときにのみ、変更されます。
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| アクティビティ | itemActivity コレクション | このアイテムに対して行われた最近のアクティビティのリストです。 |
| 分析 | itemAnalytics リソース | このアイテムについて行われたビュー アクティビティに関する分析。 |
| children | driveItem コレクション | アイテムの直接の子のアイテム オブジェクトを格納するコレクション。子が含まれるのは、フォルダーを表すアイテムのみです。読み取り専用です。Null 許容型。 |
| createdByUser | [user][] | アイテムを作成したユーザーの ID です。読み取り専用です。 |
| lastModifiedByUser | [user][] | アイテムを最後に変更したユーザーの ID です。読み取り専用です。 |
| listItem | listItem | SharePoint のドライブの場合は、関連付けられているドキュメント ライブラリのリスト アイテム。読み取り専用。Null 許容型です。 |
| アクセス許可 | permission コレクション | アイテムのアクセス許可のセット。読み取り専用です。Null 許容型。 |
| subscriptions | subscription コレクション | アイテムのサブスクリプションのセット。 ドライブのルートでのみサポートされています。 |
| thumbnails | thumbnailSet コレクション | アイテムに関連付けられた ThumbnailSet オブジェクトを格納するコレクション。詳細については、サムネイルの取得についてのページをご覧ください。読み取り専用です。Null 許容型。 |
| versions | driveItemVersion コレクション | アイテムの以前のバージョンのリスト。 詳細については、「[バージョンの一覧表示][]」を参照してください。 読み取り専用です。 Null 許容型。 |
| workbook | workbook | Excel スプレッドシートであるファイルの場合、スプレッドシートのコンテンツを操作するためにブックの API にアクセスします。Null 許容型。 |
インスタンスの属性
インスタンスの属性は、動作が特殊なプロパティです。これらのプロパティは一時的なものであり、a) サービスの動作を定義するか、b) 短期的なプロパティの値 (有効期限を持つアイテムのダウンロード URL など) を提供します。
| プロパティ名 | 種類 | 説明 |
|---|---|---|
| @microsoft.graph.conflictBehavior | string | 新しいアイテムを作成するアクションの競合を解決する動作。fail、replace、rename という値を使用できます。PUT の既定値は replace です。この注釈とともにアイテムが返されることはありません。書き込み専用です。 |
| @microsoft.graph.downloadUrl | string | このファイルのコンテンツをダウンロードするために使用できる URL。この URL では認証は必要ありません。読み取り専用です。 |
| @microsoft.graph.sourceUrl | string | PUT 要求を発行するときにこのインスタンスの注釈を使用すると、サービスに対し、URL のコンテンツをダウンロードし、それをファイルとして保存するように指示できます。書き込み専用です。 |
注:@microsoft.graph.downloadUrl の値は短時間限定の URL であるため、キャッシュすることはできません。 URL は短い期間 (1 時間) だけ使用でき、その後は無効になります。 ユーザーのファイルへのアクセス許可を削除しても、すぐに URL が無効にならない場合があります。
注: パラメーター @microsoft.graph.conflictBehavior は、要求の本文ではなく URL に含める必要があります。
JSON 表記
以下は、driveItem リソースの JSON 表記です。
**driveItem** リソースは [**baseItem**][baseItem] から派生し、そのリソースからプロパティを継承します。
{
"audio": { "@odata.type": "microsoft.graph.audio" },
"bundle": { "@odata.type": "microsoft.graph.bundle" },
"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" },
"media": { "@odata.type": "microsoft.graph.media" },
"package": { "@odata.type": "microsoft.graph.package" },
"pendingOperations": { "@odata.type": "microsoft.graph.pendingOperations" },
"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,
"source": { "@odata.type": "microsoft.graph.driveItemSource" },
"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" }],
"createdByUser": { "@odata.type": "microsoft.graph.user" },
"lastModifiedByUser": { "@odata.type": "microsoft.graph.user" },
"permissions": [ {"@odata.type": "microsoft.graph.permission"} ],
"subscriptions": [ {"@odata.type": "microsoft.graph.subscription"} ],
"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"
}
フィードバック
フィードバックの送信と表示