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.

メソッドMethods

メソッドMethod 戻り値の種類Return type 説明Description
ドライブを取得するGet drive ドライブdrive ドライブに関するメタデータを取得するGet metadata about a user's default drive on OneDrive.
ドライブのルートを取得するGet drive root driveItemdriveItem ドライブのルート フォルダーを取得するGet root folder for a drive
アクティビティを一覧表示するList activities itemActivity コレクションitemActivity collection ドライブの下に発生したアクティビティを一覧表示するList activities that occurred under the drive
フォローされたアイテムを一覧表示するList followed Items driveItem コレクションdriveItem collection ユーザーのフォローされたドライブアイテムを一覧表示するList the user's followed driveItems
子を一覧表示するList children driveItem コレクションdriveItem collection ドライブのルート フォルダーの子を一覧表示するList children of the root folder of a drive
変更を一覧表示するList changes driveItem コレクションdriveItem collection ドライブ内のすべてのドライブアイテムの変更を一覧表示するList changes for all Items in the Drive
検索Search driveItem コレクションdriveItem collection ドライブでドライブアイテムを検索するSearch for driveItems in a drive
特殊なフォルダーを取得するGet special folder driveItemdriveItem 特殊なフォルダーに正規名でアクセスするAccess a special (named) folder in the user's OneDrive by its known name.

プロパティ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.
descriptiondescription 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.
バンドルMultiple bundles driveItem コレクションdriveItem collection バンドル のコレクション (アルバムとアイテムの複数選択共有セット)。Collection of bundles (albums and multi-select-shared sets of items). 個人用 OneDrive でのみ。Only in personal OneDrive.
フォロー中following driveItem コレクションdriveItem collection ユーザーがフォローしているアイテムの一覧。The list of items the user is following. OneDrive for Business のみ。Only in OneDrive for Business.
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.

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"}
}