バンドルを取得する
[アーティクル]
03/15/2024
7 人の共同作成者
フィードバック
この記事の内容
名前空間: microsoft.graph
バンドル の一意の ID に基づいてバンドルのメタデータを取得します。
この API は、次の国内クラウド展開 で使用できます。
グローバル サービス
米国政府機関 L4
米国政府機関 L5 (DOD)
21Vianet が運営する中国
✅
✅
✅
✅
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ 、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類 」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください 。
アクセス許可の種類
最小特権アクセス許可
特権の高いアクセス許可
委任 (職場または学校のアカウント)
サポートされていません。
サポートされていません。
委任 (個人用 Microsoft アカウント)
Files.Read
Files.Read.All、Files.ReadWrite、Files.ReadWrite.All
アプリケーション
サポートされていません。
サポートされていません。
HTTP 要求
GET /drive/bundles/{bundle-id}
GET /drive/items/{bundle-id}
バンドルはアイテムであるため、 items コレクションを使用してバンドルに関するメタデータを返すことができます。
また、 バンドル コレクションを 便利に使用して、応答でバンドルを確実に取得することもできます。
オプションのクエリ パラメーター
このメソッドは、応答をカスタマイズするための OData クエリ パラメーター をサポートします。
名前
説明
Authorization
ベアラー {token}。 必須です。 認証と承認 の詳細については、こちらをご覧ください。
if-none-match
Etag。 省略可能です。 この要求ヘッダーが含まれており、指定された eTag (または cTag) がファイルの現在のタグと一致する場合は、 304 Not Modified
応答が返されます。
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは200 OK
応答コードと、応答本文にバンドル を含む driveItem オブジェクトを返します。
エラー応答の詳細については、「 Microsoft Graph のエラー応答とリソースの種類 」を参照してください。
例
例 1: バンドルを取得する
要求
次の例は要求を示しています。
GET https://graph.microsoft.com/v1.0/drive/bundles/{bundle-id}
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Drives["{drive-id}"].Bundles["{driveItem-id}"].GetAsync();
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
//other-imports
)
graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)
bundles, err := graphClient.Drives().ByDriveId("drive-id").Bundles().ByDriveItemId("driveItem-id").Get(context.Background(), nil)
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
DriveItem result = graphClient.drives().byDriveId("{drive-id}").bundles().byDriveItemId("{driveItem-id}").get();
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
const options = {
authProvider,
};
const client = Client.init(options);
let driveItem = await client.api('/drive/bundles/{bundle-id}')
.get();
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
<?php
use Microsoft\Graph\GraphServiceClient;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$result = $graphServiceClient->drives()->byDriveId('drive-id')->bundles()->byDriveItemId('driveItem-id')->get()->wait();
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
from msgraph import GraphServiceClient
graph_client = GraphServiceClient(credentials, scopes)
result = await graph_client.drives.by_drive_id('drive-id').bundles.by_drive_item_id('driveItem-id').get()
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-type: application/json
{
"id": "0123456789abc",
"name": "My Photo Album Bundle",
"eTag": "etag",
"cTag": "etag",
"createdBy": { "user": { "id": "1234", "displayName": "Ryan Gregg" } },
"createdDateTime": "datetime",
"lastModifiedBy": { "user": { "id": "1234", "displayName": "Ryan Gregg" } },
"lastModifiedDateTime": "datetime",
"size": 1234,
"webUrl": "http://onedrive.com/...",
"bundle": {
"childCount": 4,
"album": { }
}
}
例 2: バンドルとその子を 1 回の呼び出しで取得する
クエリ文字列パラメーター をexpand
使用して、バンドルのメタデータを取得するのと同じ要求にバンドルの子を含めます。
要求
次の例は要求を示しています。
GET https://graph.microsoft.com/v1.0/drive/items/{bundle-id}?expand=children
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Drives["{drive-id}"].Items["{driveItem-id}"].GetAsync((requestConfiguration) =>
{
requestConfiguration.QueryParameters.Expand = new string []{ "children" };
});
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphdrives "github.com/microsoftgraph/msgraph-sdk-go/drives"
//other-imports
)
graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)
requestParameters := &graphdrives.DriveItemItemItemRequestBuilderGetQueryParameters{
Expand: [] string {"children"},
}
configuration := &graphdrives.DriveItemItemItemRequestBuilderGetRequestConfiguration{
QueryParameters: requestParameters,
}
items, err := graphClient.Drives().ByDriveId("drive-id").Items().ByDriveItemId("driveItem-id").Get(context.Background(), configuration)
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
DriveItem result = graphClient.drives().byDriveId("{drive-id}").items().byDriveItemId("{driveItem-id}").get(requestConfiguration -> {
requestConfiguration.queryParameters.expand = new String []{"children"};
});
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
const options = {
authProvider,
};
const client = Client.init(options);
let driveItem = await client.api('/drive/items/{bundle-id}?expand=children')
.get();
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Drives\Item\Items\Item\DriveItemItemRequestBuilderGetRequestConfiguration;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestConfiguration = new DriveItemItemRequestBuilderGetRequestConfiguration();
$queryParameters = DriveItemItemRequestBuilderGetRequestConfiguration::createQueryParameters();
$queryParameters->expand = ["children"];
$requestConfiguration->queryParameters = $queryParameters;
$result = $graphServiceClient->drives()->byDriveId('drive-id')->items()->byDriveItemId('driveItem-id')->get($requestConfiguration)->wait();
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
from msgraph import GraphServiceClient
from msgraph.generated.drives.item.items.item.drive_item_item_request_builder import DriveItemItemRequestBuilder
graph_client = GraphServiceClient(credentials, scopes)
query_params = DriveItemItemRequestBuilder.DriveItemItemRequestBuilderGetQueryParameters(
expand = ["children"],
)
request_configuration = DriveItemItemRequestBuilder.DriveItemItemRequestBuilderGetRequestConfiguration(
query_parameters = query_params,
)
result = await graph_client.drives.by_drive_id('drive-id').items.by_drive_item_id('driveItem-id').get(request_configuration = request_configuration)
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
応答
次の例は応答を示しています。 この呼び出しは、バンドル メタデータとバンドルの子の一覧を返します。
バンドルに子がない場合は、空のコレクションが返されます。
バンドル内の子の数が既定のページ サイズより大きい場合、 children@odata.nextLink プロパティは、バンドル内の子の次のページを要求するために使用できる URL で返されます。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-Type: application/json
{
"id": "101230100alkc",
"name": "My Cool Day at the Beach",
"children": [
{ "id": "120100abab", "name": "image1.jpg", "file": {} },
{ "id": "120100abo1", "name": "image2.jpg", "file": {} }
],
"children@odata.nextLink": "https://api.onedrive.com/v1.0/..."
}