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

# GET (/users/xuid({xuid})/scids/{scid}/stats)

> GET (/users/xuid({xuid})/scids/{scid}/stats)

# GET (/users/xuid({xuid})/scids/{scid}/stats)

指定されたユーザーに代わって、コンマ区切りのユーザー統計名リストによってスコープが指定されたサービス構成を取得します。
これらの URI のドメインは `userstats.xboxlive.com` です。

* [解説](#ID4EV)
* [URI パラメーター](#ID4EEB)
* [クエリ文字列パラメーター](#ID4EPB)
* [認可](#ID4EUC)
* [必須要求ヘッダー](#ID4EPD)
* [省略可能な要求ヘッダー](#ID4EYE)
* [要求本文](#ID4E3F)
* [HTTP 状態コード](#ID4EHG)
* [応答本文](#ID4E5BAC)

## 解説

クライアントは、新しいプレイヤー統計システムにおいて、プレイヤーに代わってタイトルの統計情報を読み書きする方法を必要とします。

## URI パラメーター

| パラメーター | 型 | 説明 |
| - | - | - |
| xuid | GUID | サービス構成にアクセスする代わりとなるユーザーの XBOX ユーザー ID (XUID)。 |
| scid | GUID | アクセスされるリソースを含むサービス構成の識別子。 |

## クエリ文字列パラメーター

\| パラメーター | 型 | 説明 |
\| --- | --- | --- | --- | --- | --- |
\| statNames | string | 唯一のクエリ文字列パラメーターは、コンマ区切りのユーザー統計名 URI 名詞です。たとえば、次の URI は、URI で指定されたユーザー ID の代わりに 4 つの統計を要求していることをサービスに通知します。`https://userstats.xboxlive.com/users/xuid({xuid})/scids/{scid}/stats/wins,kills,kdratio,headshots` 1 回の呼び出しで要求できる統計の数には制限があり、その制限は開発者の利便性と URI 長の実用性の "スイート スポット" を慎重に考慮しています。たとえば、制限は 600 文字分の統計名テキスト (コンマを含む) または最大 10 個の統計によって決定されることがあります。このような単純な GET を有効にすると、よく要求される統計に対して HTTP キャッシュが有効になり、頻繁に呼び出すクライアントからの呼び出し量を削減できます。 |

## 認可

コンテンツの分離とアクセス制御のシナリオを実装する認可ロジックがあります。

* リーダーボードとユーザー統計はいずれも、呼び出し元が要求と共に有効な XSTS トークンを送信していれば、任意のプラットフォームのクライアントから読み取ることができます。書き込みは、当然、Player Data システムがサポートしているクライアントに限られます。
* タイトル開発者はパートナー センターを使用して、統計を open または restricted としてマークできます。リーダーボードは open 統計です。open 統計は、ユーザーがサンドボックスに対して認可されている限り、Smartglass、iOS、Android、Windows、Windows Phone、および Web アプリケーションからアクセスできます。サンドボックスに対するユーザーの認可は、パートナー センターを通じて管理されます。

チェックの疑似コードは次のようになります。

```cpp theme={null}
If (!checkAccess(serviceConfigId, resource, CLAIM[userid, deviceid, titleid]))
{
        Reject request as Unauthorized
}

// else accept request.

```

## 必須要求ヘッダー

\| ヘッダー | 型 | 説明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization | string | HTTP 認証用の認証資格情報。例: "XBL3.0 x=\<userhash>;\<token>"。 |

## 省略可能な要求ヘッダー

\| ヘッダー | 型 | 説明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| X-RequestedServiceVersion |  | この要求がルーティングされるサービスのビルド名/番号。要求は、ヘッダーの妥当性、認証トークンのクレームなどが確認された後にのみ、そのサービスにルーティングされます。既定値: 1。 |

## 要求本文

この要求の本文にはオブジェクトは送信されません。

## HTTP 状態コード

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

\| コード | 理由句 | 説明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200 | OK | セッションが正常に取得されました。 |
\| 304 | Not Modified | 前回要求されてからリソースが変更されていません。 |
\| 400 | Bad Request | サービスは正しくない形式の要求を解釈できませんでした。通常は無効なパラメーターです。 |
\| 401 | Unauthorized | 要求にはユーザー認証が必要です。 |
\| 403 | Forbidden | 要求はユーザーまたはサービスに対して許可されていません。 |
\| 404 | Not Found | 指定されたリソースが見つかりませんでした。 |
\| 406 | Not Acceptable | リソース バージョンがサポートされていません。 |
\| 408 | Request Timeout | リソース バージョンがサポートされていません。MVC 層で拒否される必要があります。 |

## 応答本文

### 応答例

```cpp theme={null}
{
    "user": {
    "xuid": "123456789",
        "gamertag": "WarriorSaint",
        "stats": [
            {
                "statname": "Wins",
                "type": "Integer",
                "value": 40
            },
            {
                "statname": "Kills",
                "type": "Integer",
                "value": 700
            },
            {
                "statname": "KDRatio",
                "type": "Double",
                "value": 2.23
            },
            {
                "statname": "Headshots",
                "type": "Integer",
                "value": 173
            }
        ],
    }
}

```

## 関連項目

##### 親

[/users/xuid({xuid})/scids/{scid}/stats](https://docs.xbox.com/ja-jp/reference/live/rest/uri/userstats/uri-usersxuidscidsscidstats.md)


## Related topics

- [/users/xuid({xuid})/scids/{scid}/stats](https://docs.xbox.com/ja-jp/reference/live/rest/uri/userstats/uri-usersxuidscidsscidstats.md)
- [GET (/users/xuid({xuid})/achievements/{scid}/{achievementid})](https://docs.xbox.com/ja-jp/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidachievementidget.md)
- [/users/xuid({xuid})/achievements/{scid}/{achievementid}](https://docs.xbox.com/ja-jp/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidachievementid.md)
- [/users/xuid({xuid})/achievements/{scid}/update](https://docs.xbox.com/ja-jp/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidupdate.md)
- [POST (/users/xuid({xuid})/achievements/{scid}/update)](https://docs.xbox.com/ja-jp/reference/live/rest/uri/achievements/uri-usersxuidachievementsscidupdatepost.md)