リストバンドル

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

名前空間: microsoft.graph

ユーザーのドライブ内のすべての [バンドル][バンドルの] 一覧を取得します。

アクセス許可

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

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

HTTP 要求

GET /drive/bundles

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

このメソッドは、応答をフィルター処理してシェイプするための OData クエリパラメーターをサポートします。

バンドルを列挙するときにクエリ expand=children パラメーターを使用することはできません。

要求ヘッダー

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

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、この要求はドライブに定義されているバンドルアイテムの一覧を返します。

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

例

例 1: ドライブ内のすべてのバンドルを一覧表示する

ドライブで定義されているすべてのバンドルの列挙を要求するには、パラメーターなしで bundles コレクションに要求を行います。

要求

GET https://graph.microsoft.com/beta/drive/bundles

応答

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

{
  "value": [
    {
      "id": "0123456789abc",
      "name": "Vacation photo album",
      "bundle": {
        "childCount": 1,
        "album": { }
      }
    },
    {
      "id": "0120310201abd",
      "name": "Family shared files",
      "bundle": {
        "childCount": 1
      }
    }
  ],
  "@odata.nextLink": "https://..."
}

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

例 2: ドライブ内のすべてのフォトアルバムを一覧表示する

要求から bundles filter コレクションに返されるバンドルの一覧をフィルター処理するには、クエリ文字列パラメーターを使用して、バンドルにファセットが存在しないか確認して、返すバンドルの種類を指定できます。

要求

GET https://graph.microsoft.com/beta/drive/bundles?filter=bundle/album%20ne%20null

応答

バンドルエンドポイントへの GET への応答は、バンドルを含む driveItem リソースの配列 [です][]。すべてのバンドルはアイテムなので、すべての標準アイテム操作を使用できます。

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

{
  "value": [
    {
      "id": "0123456789abc",
      "name": "Vacation photo album",
      "bundle": {
        "childCount": 1,
        "album": { }
      }
    },
    {
      "id": "120301010abcd",
      "name": "Seattle Center event",
      "bundle": {
        "childCount": 4,
        "album": { }
      },
      "tags": [
        {
          "name": "outside",
          "autoTagged": { }
        }
      ]
    }
  ]
}

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

リスト バンドル