次の方法で共有


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 値は、子孫から派生したプロパティ (childCountlastModifiedDateTime など) 以外のフォルダーのプロパティが変更されたときにのみ、変更されます。

リレーションシップ

リレーションシップ 説明
アクティビティ itemActivity コレクション このアイテムに対して行われた最近のアクティビティのリストです。
children driveItem コレクション アイテムの直接の子のアイテム オブジェクトを格納するコレクション。 子が含まれるのは、フォルダーを表すアイテムのみです。 読み取り専用です。 Null 許容型。
listItem listItem SharePoint のドライブの場合は、関連付けられているドキュメント ライブラリのリスト アイテム。 読み取り専用です。 Null 許容型。
アクセス許可 permission コレクション アイテムのアクセス許可のセット。 読み取り専用です。 Null 許容型。
thumbnails thumbnailSet コレクション アイテムに関連付けられた ThumbnailSet オブジェクトを格納するコレクション。 詳細については、サムネイルの取得についてのページを参照してください。 読み取り専用です。 Null 許容型。
versions driveItemVersion コレクション アイテムの以前のバージョンのリスト。 詳細については、「バージョンの一覧表示」を参照してください。 読み取り専用です。 Null 許容型。

インスタンスの属性

インスタンスの属性は、動作が特殊なプロパティです。 これらのプロパティは一時的なものであり、a) サービスの動作を定義するか、b) 短期的なプロパティの値 (有効期限を持つアイテムのダウンロード URL など) を提供します。

プロパティ名 種類 説明
@microsoft.graph.conflictBehavior string 新しいアイテムを作成するアクションの競合を解決する動作。 使用できる値は failreplace、または 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 プロパティは返されません。