次の方法で共有


ドライブを取得する

名前空間: microsoft.graph

Drive リソースのプロパティと関係を取得します。

ドライブとは、OneDrive または SharePoint のドキュメント ライブラリなど、ファイル システムの最上位コンテナーです。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください

アクセス許可の種類 最小特権アクセス許可 特権の高いアクセス許可
委任 (職場または学校のアカウント) Files.Read Files.Read.All、Files.ReadWrite、Files.ReadWrite.All、Sites.Read.All、Sites.ReadWrite.All、User.Read
委任 (個人用 Microsoft アカウント) Files.Read Files.Read.All、Files.ReadWrite、Files.ReadWrite.All
アプリケーション サポートされていません。 サポートされていません。

HTTP 要求

現在のユーザーの OneDrive を取得する

(委任された認証を使用する場合) me シングルトンから、サインイン ユーザーのドライブにアクセスできます。

ユーザーの OneDrive がプロビジョニングされていないが、ユーザーが OneDrive を使用するライセンスを持っている場合、委任された認証を使用すると、この要求によってユーザーのドライブが自動的にプロビジョニングされます。

GET /me/drive

ユーザーの OneDrive を取得する

ユーザーの OneDrive または OneDrive for Business にアクセスするには、User リソースについてのドライブ リレーションシップをアプリが要求する必要があります。

ユーザーの OneDrive がプロビジョニングされていないが、ユーザーが OneDrive を使用するライセンスを持っている場合、委任された認証を使用すると、この要求によってユーザーのドライブが自動的にプロビジョニングされます。

GET https://graph.microsoft.com/v1.0/users/{idOrUserPrincipalName}/drive

パス パラメーター

パラメーター名 説明
idOrUserPrincipalName string 必須。 OneDrive を所有するユーザー オブジェクトの識別子。

グループに関連付けられたドキュメント ライブラリを取得する

グループの既定のドキュメント ライブラリにアクセスするには、そのグループについてのドライブ リレーションシップをアプリが要求する必要があります。

GET /groups/{groupId}/drive

パス パラメーター

パラメーター名 説明
groupId string 必須です。 ドキュメント ライブラリを所有するグループの識別子。

サイトのドキュメント ライブラリを取得する

サイトの既定のドキュメント ライブラリにアクセスするには、そのサイトについてのドライブ リレーションシップをアプリが要求する必要があります。

GET /sites/{siteId}/drive

パス パラメーター

パラメーター名 説明
siteId string 必須。 ドキュメント ライブラリを含むサイトの識別子。

ID によりドライブを取得する

ドライブの一意の識別子を持っている場合、最上位ドライブのコレクションから直接アクセスできます。

GET /drives/{driveId}

パス パラメーター

パラメーター名 説明
driveId string 必須。 要求されるドライブの識別子。

オプションのクエリ パラメーター

これらのメソッドは、応答を形成するための $selectクエリ パラメーター をサポートします。

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。

応答

各メソッドは、一致するドライブに応じた Drive リソースを応答本文で返します。

エラー応答コード

ドライブが存在せず、(委任された認証を使用するときに) 自動的にプロビジョニングできない場合は、 HTTP 404 応答が返されます。

要求

GET /me/drive

応答

HTTP/1.1 200 OK
Content-type: application/json

{
    "id": "b!t18F8ybsHUq1z3LTz8xvZqP8zaSWjkFNhsME-Fepo75dTf9vQKfeRblBZjoSQrd7",
    "driveType": "business",
    "owner": {
        "user": {
            "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
            "displayName": "Ryan Gregg"
        }
    },
    "quota": {
        "deleted": 256938,
        "remaining": 1099447353539,
        "state": "normal",
        "total": 1099511627776
    }
}