Share via

DriveItem リソース型

  • [アーティクル]

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

ドライブに格納されているファイル、フォルダー、またはその他の項目を表します。

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}/contentStream
特定のファイル形式をダウンロードする GET /drive/items/{item-id}/content?format={format}
アイテムを削除する DELETE /drive/items/{item-id}
PermanentDelete 項目 POST /drives/{driveId}/items/{itemId}/permanentDelete
アイテムを復元する 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
秘密度ラベルを割り当てる POST /drive/items/{item-id}/assignSensitivityLabel
保持ラベルを取得する GET /drives/{drive-id}/items/{id}/retentionLabel
保持ラベルを設定する PATCH /drives/{drive-id}/items/{id}/retentionLabel
保持ラベルを削除する DELETE /drives/{drive-id}/items/{id}/retentionLabel
レコードをロックまたはロック解除する PATCH /drives/{drive-id}/items/{id}/retentionLabel

プロパティ

プロパティ 型 説明
audio audio オーディオのメタデータ (アイテムがオーディオ ファイルである場合)。 読み取り専用です。 OneDrive 個人用においてのみ。
バンドル バンドル バンドル メタデータ (アイテムがバンドルである場合)。 読み取り専用です。
content (非推奨) Stream コンテンツのストリーム (アイテムがファイルを表す場合)。 content プロパティは、将来、動作に重大な変化を起こす可能性があります。 リダイレクトするのではなく、コンテンツを直接ストリーミングします。 新しい動作を事前にオプトインするには、代わりに contentStream プロパティを使用します。
contentStream Stream コンテンツのストリーム (アイテムがファイルを表す場合)。
createdBy identitySet アイテムを作成したユーザー、デバイス、アプリケーションの ID。 読み取り専用です。
createdDateTime DateTimeOffset アイテム作成の日時。 読み取り専用です。
cTag String アイテムのコンテンツの eTag。 メタデータのみが変更された場合、この eTag は変更されません。 メモ アイテムがフォルダーの場合、このプロパティは返されません。 読み取り専用です。
deleted deleted アイテムの削除状態に関する情報。 読み取り専用です。
説明 String ユーザーに表示されるアイテムの説明を提供します。 読み取り/書き込み。 OneDrive 個人用においてのみ。
eTag String アイテム全体 (メタデータおよびコンテンツ) の eTag。 読み取り専用です。
file file ファイルのメタデータ (アイテムがファイルである場合)。 読み取り専用です。
fileSystemInfo fileSystemInfo クライアント上のファイル システム情報。 読み取り/書き込み。
folder 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 shared アイテムが他のユーザーと共有されたことを示し、アイテムの共有状態に関する情報を提供します。 読み取り専用です。
sharepointIds sharepointIds SharePoint REST 互換性に役立つ識別子を返します。 読み取り専用です。
size Int64 アイテムのサイズ (バイト単位)。 読み取り専用です。
specialFolder specialFolder 現在のアイテムが特別なフォルダーとしても使用可能な場合は、このファセットが返されます。 読み取り専用です。
source driveItemSource ドライブ項目のソースに関する情報。 読み取り専用。 OneDrive for Businessと SharePoint でのみ。
video video ビデオのメタデータ (アイテムがビデオである場合)。 読み取り専用です。
視点 driveItemViewpoint このドライブ項目の呼び出し元ユーザーに固有の情報を返します。 読み取り専用。
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 許容型です。
retentionLabel itemRetentionLabel driveItem に適用される保持ラベルと設定に関する情報。 読み取り/書き込み。
subscriptions subscription コレクション アイテムのサブスクリプションのセット。 ドライブのルートでのみサポートされています。
thumbnails thumbnailSet コレクション アイテムに関連付けられている thumbnailSet オブジェクトのコレクション。 詳細については、「サムネイルの 取得」を参照してください。 読み取り専用。 Null 許容型です。
versions driveItemVersion コレクション アイテムの以前のバージョンのリスト。 詳細については、「バージョンの一覧表示」を参照してください。 読み取り専用です。 Null 許容型。
workbook workbook Excel スプレッドシートであるファイルの場合は、ブック API にアクセスしてスプレッドシートの内容を操作します。 Null 許容型。

インスタンスの属性

インスタンスの属性は、動作が特殊なプロパティです。 これらのプロパティは一時的なもので、サービスが実行する必要がある動作を定義するか、期限切れのアイテムのダウンロード URL などの短期的なプロパティ値を指定します。

プロパティ名 種類 説明
@microsoft.graph.conflictBehavior string 新しいアイテムを作成するアクションの競合を解決する動作。 使用できる値は fail、replace、または rename です。 PUT の既定値は replace です。 この注釈を使用して項目が返されることはありません。 書き込み専用です。
@microsoft.graph.downloadUrl string このファイルのコンテンツをダウンロードするために使用できる URL。 この URL では認証は必要ありません。 読み取り専用です。
@microsoft.graph.sourceUrl 文字列 このインスタンス注釈を使用すると、PUT 要求を発行するときに URL の内容をダウンロードするようにサービスに指示し、ファイルとして格納できます。 書き込み専用です。

注: パラメーター @microsoft.graph.conflictBehavior は、要求の本文ではなく URL に含める必要があります。

@microsoft.graph.downloadUrl の値は短時間限定の URL であるため、キャッシュすることはできません。 URL は、短時間 (1 時間) の後に無効になります。 ユーザーのファイルへのアクセス許可を削除しても、すぐに URL が無効にならない可能性があります。

ファイルのアップロードへの @microsoft.graph.sourceUrl プロパティの使用は、OneDrive for Business、SharePoint Online および SharePoint Server 2016 ではサポートされていません。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

driveItem リソースは baseItem から派生し、そのリソースからプロパティを継承します。

{
  "audio": { "@odata.type": "microsoft.graph.audio" },
  "bundle": { "@odata.type": "microsoft.graph.bundle" },
  "content": { "@odata.type": "Edm.Stream" },
  "contentStream": { "@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" },
  "viewpoint": { "@odata.type": "microsoft.graph.driveItemViewpoint" },
  "webDavUrl": "string",

  /* relationships */
  "activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
  "children": [{ "@odata.type": "microsoft.graph.driveItem" }],
  "createdByUser": { "@odata.type": "microsoft.graph.user" },
  "retentionLabel": { "@odata.type": "microsoft.graph.itemRetentionLabel" },
  "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"
}