バンドルの作成

[アーティクル]
04/06/2022

名前空間: microsoft.graph

ユーザーのドライブ [に新][] しいバンドルを追加します。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

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

HTTP 要求

POST /drive/bundles

要求ヘッダー

名前	説明
Authorization	ベアラー {トークン}。必須。

要求本文

要求本文で、作成するバンドルの JSON 表記を指定します。

応答

要求が成功すると、新しく作成されたバンドルを表す driveItem が返されます。

エラー応答の詳細については、「エラー応答」を参照してください。

例

例 1: バンドルの作成

次の例は、基本的な新しいバンドルを作成する方法を示しています。この要求では、という名前の新しいバンドルが作成され Just some files 、2 つの既存のアイテムがバンドルに追加されます。このバンドルを使用すると、それらのアイテムが保存されているフォルダーを共有せずに、他のユーザーとファイルのコレクションを共有できます。

要求

POST https://graph.microsoft.com/beta/drive/bundles
Content-Type: application/json

{
  "name": "Just some files",
  "@microsoft.graph.conflictBehavior" : "rename",
  "bundle": { },
  "children": [
    { "id": "1234asdf" },
    { "id": "1234qwerty" }
  ]
}

応答

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "1234321!abc",
  "name": "Just some files",
  "bundle": {
    "childCount": 2
  }
}

ここに示す応答オブジェクトは、読みやすさのために短縮されている可能性があります。

例 2: アルバムを作成する

新しいフォトアルバムを作成する要求は似ていますが、バンドルファセット内では、アルバムプロパティは null 以外の値に設定されます。

要求

POST https://graph.microsoft.com/beta/drive/bundles
Content-Type: application/json

{
  "name": "My Day at the Beach",
  "@microsoft.graph.conflictBehavior" : "rename",
  "bundle": { "album": {} },
  "children": [
    { "id": "1234asdf" }
  ]
}

応答

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "1234321!abc",
  "name": "Just some files",
  "bundle": {
    "childCount": 2,
    "album": { }
 }
}