Drive リソース型drive resource type

重要

Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでは、これらの API の使用はサポートされていません。Use of these APIs in production applications is not supported.

ドライブ リソースは、ユーザーの OneDrive または SharePoint のドキュメント ライブラリを表す、最上位のオブジェクトです。The drive resource is the top level object representing a user's OneDrive or a document library in SharePoint.

OneDrive のユーザーは、少なくとも 1 つのドライブ (そのユーザーの既定のドライブ) を常に使用できます。OneDrive のライセンスが付与されていないユーザーには、使用可能な既定のドライブがないことがあります。OneDrive users will always have at least one drive available, their default drive. Users without a OneDrive license may not have a default drive available.

JSON 表記JSON representation

Drive リソースの JSON 表記を以下に示します。Here is a JSON representation of a Drive resource.

drive リソースは baseItem から派生しており、そのリソースからプロパティを継承しています。The drive resource is derived from baseItem and inherits properties from that resource.

{
  "activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
  "id": "string",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "string (timestamp)",
  "description": "string",
  "driveType": "personal | business | documentLibrary",
  "following": [{"@odata.type": "microsoft.graph.driveItem"}],
  "items": [{"@odata.type": "microsoft.graph.driveItem"}],
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "string (timestamp)",
  "name": "string",
  "owner": {"@odata.type": "microsoft.graph.identitySet"},
  "quota": {"@odata.type": "microsoft.graph.quota"},
  "root": {"@odata.type": "microsoft.graph.driveItem"},
  "special": [{"@odata.type": "microsoft.graph.driveItem"}],
  "system": {"@odata.type": "microsoft.graph.systemFacet"},
  "webUrl": "string",
  "sharepointIds": {"@odata.type": "microsoft.graph.sharepointIds"}
}

プロパティProperties

プロパティProperty Type 説明Description
createdBycreatedBy identitySetidentitySet アイテムを作成したユーザーの ID、デバイス、アプリケーション。読み取り専用です。Identity of the user, device, or application which created the item. Read-only.
createdDateTimecreatedDateTime dateTimeOffsetdateTimeOffset アイテム作成の日時。読み取り専用です。Date and time of item creation. Read-only.
説明description StringString ユーザーに表示されるドライブの説明を提供します。Provide a user-visible description of the drive. 読み取り/書き込み。Read-write.
driveTypedriveType StringString このリソースで表されるドライブの種類についての説明。OneDrive 個人用のドライブは personal を返します。OneDrive for Business は business を返します。SharePoint ドキュメント ライブラリは documentLibrary を返します。読み取り専用。Describes the type of drive represented by this resource. OneDrive personal drives will return personal. OneDrive for Business will return business. SharePoint document libraries will return documentLibrary. Read-only.
idid StringString ドライブの一意識別子。読み取り専用。The unique identifier of the drive. Read-only.
lastModifiedBylastModifiedBy identitySetidentitySet アイテムを最終更新したユーザーの ID、デバイス、アプリケーション。読み取り専用です。Identity of the user, device, and application which last modified the item. Read-only.
lastModifiedDateTimelastModifiedDateTime dateTimeOffsetdateTimeOffset アイテムが最後に変更された日時。読み取り専用です。Date and time the item was last modified. Read-only.
namename stringstring アイテムの名前。読み取り/書き込み。The name of the item. Read-write.
ownerowner identitySetidentitySet 省略可能。ドライブを所有しているユーザー アカウント。読み取り専用です。Optional. The user account that owns the drive. Read-only.
quotaquota quotaquota 省略可能。ドライブの記憶領域クォータに関する情報。読み取り専用です。Optional. Information about the drive's storage space quota. Read-only.
sharepointIdssharepointIds sharepointIdssharepointIds SharePoint REST 互換性に役立つ識別子を返します。読み取り専用です。Returns identifiers useful for SharePoint REST compatibility. Read-only.
systemsystem systemFacetsystemFacet 存在する場合は、これがシステム管理のドライブであることを示しています。If present, indicates that this is a system-managed drive. 読み取り専用です。Read-only.
webUrlwebUrl string (URL)string (url) ブラウザーでリソースを表示するための URL。読み取り専用です。URL that displays the resource in the browser. Read-only.

リレーションシップRelationships

リレーションシップRelationship Type 説明Description
アクティビティactivities itemActivity コレクションitemActivity collection このドライブに対して行われた最近のアクティビティのリストです。The list of recent activities that took place under this drive.
itemsitems driveItem コレクションdriveItem collection ドライブに含まれているすべてのアイテム。読み取り専用。Null 許容型。All items contained in the drive. Read-only. Nullable.
rootroot driveItemdriveItem ドライブのルート フォルダー。読み取り専用。The root folder of the drive. Read-only.
specialspecial driveItem コレクションdriveItem collection OneDrive で使用可能な共通フォルダーのコレクション。読み取り専用。Null 許容型。Collection of common folders available in OneDrive. Read-only. Nullable.
フォロー中following driveItem コレクションdriveItem collection ユーザーがフォローしているアイテムの一覧。The list of items the user is following. OneDrive for Business のみ。Only in OneDrive for Business.

メソッドMethods

共通タスクCommon task HTTP メソッドHTTP method
別の Drive の Drive メタデータを取得するGet Drive metadata of another Drive GET /drives/{drive-id}
ユーザーの既定のドライブのルート フォルダーを取得するGet root folder for user's default Drive GET /drive/root
ドライブのアクティビティを一覧表示するList activities under the Drive GET /drive/activities
フォローされたアイテムを一覧表示するList followed Items GET /drive/following
ドライブの子を一覧表示するList children under the Drive GET /drive/root/children
ドライブ内のすべてのアイテムの変更を一覧表示するList changes for all Items in the Drive GET /drive/root/delta
ドライブ内のアイテムを検索するSearch for Items in the Drive GET /drive/root/search
特別なフォルダーにアクセスするAccess special folder GET /drive/special/{name}

前の表では例に /drive を使用していますが、他のパスも有効です。In the previous table, the examples use /drive, but other paths are valid too.