Skip to main content

POST (/json/users/batch/scids//data/,json)

同じファイル名で複数のユーザーから複数のファイルをダウンロードします。ダウンロードするファイルはリクエストの URI によって決定されます。リクエストの本文には、ファイルをダウンロードするユーザーの XUID のリストが含まれます。レスポンスの本文はマルチパート MIME メッセージで、各パートは特定のユーザーのファイルを表し、それぞれ独自のヘッダー セットを持ちます。レスポンスのパートは、成功と失敗が混在している可能性があります。 これらの URI のドメインは titlestorage.xboxlive.com です。

URI パラメーター

認可

リクエストには、有効な XBOX LIVE 認可ヘッダーを含める必要があります。呼び出し元がこのリソースへのアクセスを許可されていない場合、サービスは 403 Forbidden レスポンスを返します。ヘッダーが無効または欠落している場合、サービスは 401 Unauthorized レスポンスを返します。

リクエスト本文

| プロパティ | 型 | 説明 | | --- | --- | --- | --- | --- | --- | | xuids| array of unsigned 64-bit integers| ファイルをダウンロードする対象の XUID のリスト。|

サンプル リクエスト

HTTP ステータス コード

サービスは、このリソースに対してこのメソッドで行われたリクエストへの応答として、このセクション内のいずれかのステータス コードを返します。XBOX Live Services で使用される標準の HTTP ステータス コードの完全な一覧については、標準 HTTP ステータス コード を参照してください。 | コード | 理由 | 説明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK | リクエストは成功しました。| | 201| Created | エンティティが作成されました。| | 400| Bad Request | サービスが不正な形式のリクエストを認識できませんでした。通常は無効なパラメーターです。| | 401| Unauthorized | リクエストにはユーザー認証が必要です。| | 403| Forbidden | このリクエストは、ユーザーまたはサービスに対して許可されていません。| | 404| Not Found | 指定されたリソースが見つかりませんでした。| | 406| Not Acceptable | リソース バージョンがサポートされていません。| | 408| Request Timeout | リクエストの完了に時間がかかりすぎました。| | 500| Internal Server Error | サーバーで予期しない状況が発生し、リクエストを実行できませんでした。| | 503| Service Unavailable | リクエストがスロットリングされました。client-retry の値 (秒数) を経過してからリクエストを再試行してください (例: 5 秒後)。|

必須レスポンス ヘッダー

| ヘッダー | 説明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Content-Disposition| パートの内容を表します。ヘッダーの “name” および “filename” 部分は、このファイルが属するユーザーの XUID です。| | HttpStatusCode| この特定のファイルの取得に関連する HTTP ステータス コード。|

オプションのレスポンス ヘッダー

| ヘッダー | 説明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | ETag| ETag は、URL で見つかったリソースの特定のバージョンに Web サーバーによって割り当てられた不透明な識別子です。その URL のリソース コンテンツが変更されると、新しい別の ETag が割り当てられます。| | Content-Type| ファイルが正常に取得された場合、これはファイルの Content-Type です。| | Content-Range| ファイルが正常に取得され、部分ダウンロードの場合、これはレスポンスに含まれるファイルのバイト範囲です。 |

レスポンス本文

呼び出しが成功した場合、サービスはリクエストされたファイルの内容をマルチパート レスポンスとして返します。

サンプル レスポンス

関連項目

親
/json/users/batch/scids//data/,json
Last modified on October 19, 2026