> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET (/json/users/xuid({xuid})/scids/{scid}/data/{pathAndFileName},json)

> GET (/json/users/xuid({xuid})/scids/{scid}/data/{pathAndFileName},json)

# GET (/json/users/xuid({xuid})/scids/{scid}/data/{pathAndFileName},json)

ファイルをダウンロードします。
これらの URI のドメインは `titlestorage.xboxlive.com` です。

* [URI パラメーター](#ID4EX)
* [認可](#ID4ECB)
* [オプションのクエリ文字列パラメーター](#ID4EPB)
* [必須リクエスト ヘッダー](#ID4EQC)
* [オプションのリクエスト ヘッダー](#ID4EZD)
* [リクエスト本文](#ID4EDF)
* [HTTP ステータス コード](#ID4EQF)
* [レスポンス ヘッダー](#ID4EDDAC)
* [レスポンス本文](#ID4EGEAC)

## URI パラメーター

| パラメーター | 型 | 説明 |
| - | - | - |
| xuid | unsigned 64-bit integer | リクエストを行うプレイヤーの XBOX ユーザー ID (XUID)。 |
| scid | guid | 検索するサービス構成の ID。 |
| pathAndFileName | string | アクセスする項目のパスとファイル名。パス部分 (最後のスラッシュまでを含む) に有効な文字は、英大文字 (A-Z)、英小文字 (a-z)、数字 (0-9)、アンダースコア (*)、スラッシュ (/) です。パス部分は空でも構いません。ファイル名部分 (最後のスラッシュ以降のすべて) に有効な文字は、英大文字 (A-Z)、英小文字 (a-z)、数字 (0-9)、アンダースコア (*)、ピリオド (.)、ハイフン (-) です。ファイル名を空にすること、ピリオドで終わらせること、または 2 つ連続するピリオドを含めることはできません。 |

## 認可

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

## オプションのクエリ文字列パラメーター

Blob タイプにより異なります。バイナリ Blob はクエリ パラメーターをサポートしません。

\| パラメーター | 型 | 説明 |
\| --- | --- | --- | --- | --- | --- |
\| select| string| type が json の場合にのみ使用可能。このパラメーターによって決定される、JSON の特定のプロパティ/値のみをレスポンスに含めるように指定します。サブプロパティを指定するには "ドット" (.) を使用し、配列インデックスを指定するには角括弧 ('\[' および ']') を使用します。たとえば、"array1\[4].prop2" は "array1" 配列のインデックス 4 の "prop2" プロパティを指定します。|

## 必須リクエスト ヘッダー

\| ヘッダー | 値 | 説明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| x-xbl-contract-version| 1| API コントラクト バージョン。|
\| Authorization| XBL3.0 x=\[hash];\[token]| STS 認証トークン。STSTokenString は、認証リクエストによって返されるトークンに置き換えられます。STS トークンの取得および認可ヘッダーの作成についての詳細は、Authenticating and Authorizing XBOX LIVE Services Requests を参照してください。|

## オプションのリクエスト ヘッダー

\| ヘッダー | 説明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| If-Match| 操作を完了するために、既存の項目と一致する必要のある ETag を指定します。|
\| If-None-Match| 操作を完了するために、既存のどの項目とも一致してはならない ETag を指定します。|
\| Range| ダウンロードするバイトの範囲を指定します。標準の HTTP Range ヘッダー形式に従います。|

## リクエスト本文

このリクエストの本文にはオブジェクトを送信しません。

## HTTP ステータス コード

サービスは、このリソースに対してこのメソッドで行われたリクエストへの応答として、このセクション内のいずれかのステータス コードを返します。XBOX Live Services で使用される標準の HTTP ステータス コードの完全な一覧については、[標準 HTTP ステータス コード](https://devdocs.xbox.com/ja-jp/reference/live/rest/additional/httpstatuscodes) を参照してください。

\| コード | 理由 | 説明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 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 秒後)。|

## レスポンス ヘッダー

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

## レスポンス本文

呼び出しが成功した場合、サービスはファイルの内容を返します。

## 関連項目

##### 親

[/json/users/xuid({xuid})/scids/{scid}/data/{pathAndFileName},json](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/storage/uri-jsonusersxuidscidssciddatapathandfilenametype)

##### リファレンス  [TitleBlob (JSON)](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-titleblob)


## Related topics

- [XblTitleStorageDownloadBlobAsync](https://devdocs.xbox.com/es/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobasync.md)
- [XblTitleStorageGetBlobMetadataAsync](https://devdocs.xbox.com/ko/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragegetblobmetadataasync.md)