DriveItem リソース型

名前空間: microsoft.graph

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 プロパティは返されません。

メソッド

プロパティ

注: eTag プロパティと cTag プロパティは、コンテナー (フォルダー) 上での機能が異なります。 cTag 値は、フォルダーのいずれかの子孫のコンテンツまたはメタデータが変更されると変更されます。 eTag 値は、子孫から派生したプロパティ (childCount や lastModifiedDateTime など) 以外のフォルダーのプロパティが変更されたときにのみ、変更されます。

リレーションシップ

インスタンスの属性

インスタンスの属性は、動作が特殊なプロパティです。 これらのプロパティは一時的なもので、サービスが実行する必要がある動作を定義するか、期限切れのアイテムのダウンロード 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" },
  "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" },
  "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,
  "specialFolder": { "@odata.type": "microsoft.graph.specialFolder" },
  "video": { "@odata.type": "microsoft.graph.video" },
  "webDavUrl": "string",

  /* relationships */
  "activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
  "analytics": {"@odata.type": "microsoft.graph.itemAnalytics"},
  "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 */
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "eTag": "string",
  "id": "string (identifier)",
  "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"
}