> ## 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.

# POST (/batch)

> POST (/batch)

# POST (/batch)

複数タイトルにまたがる複数プレイヤーの統計情報に対する複雑なバッチ要求のために、GET メソッドとして機能する POST メソッド。
これらの URI のドメインは `userstats.xboxlive.com` です。

## 解説

タイトル開発者はパートナー センターを使用して、統計を open または restricted としてマークできます。リーダーボードは open 統計です。open 統計は、ユーザーがサンドボックスに対して認可されている限り、Smartglass、iOS、Android、Windows、Windows Phone、および Web アプリケーションからアクセスできます。サンドボックスに対するユーザーの認可は、パートナー センターを通じて管理されます。

* [解説](#ID4ET)
* [説明](#ID4EFB)
* [認可](#ID4EUB)
* [必須要求ヘッダー](#ID4ETC)
* [省略可能な要求ヘッダー](#ID4E3D)
* [要求本文](#ID4EAF)
* [HTTP 状態コード](#ID4EWF)
* [応答本文](#ID4ENBAC)

## 説明

呼び出し元は、それらの統計を取得するためのユーザー、サービス構成 ID (SCID)、および SCID ごとの統計名リストの配列を含むメッセージ本文を提供します。

より複雑なバッチ モードのこのページを読む前に、単純な単一統計の [GET](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/userstats/uri-usersxuidscidsscidstatsget) メソッドを確認するとより理解しやすい場合があります。

## 認可

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

* リーダーボードとユーザー統計はいずれも、呼び出し元が要求と共に有効な XSTS トークンを送信していれば、任意のプラットフォームのクライアントから読み取ることができます。書き込みは、当然サポートされているクライアントに限られます。
* タイトル開発者はパートナー センターを使用して、統計を 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。 |

## 要求本文

### 要求例

次の POST 本文は、4 つの統計を 2 つの異なる SCID から 2 人の異なるユーザーに対して要求していることをサービスに通知します。

```cpp theme={null}
{    
"requestedusers": [
                1234567890123460,
                1234567890123234
            ],
            "requestedscids": [
                {
                    "scid": "c402ff50-3e76-11e2-a25f-0800200c1212",
                    "requestedstats": [
                        "Test4FirefightKills",
                        "Test4FirefightHeadshots"
                    ]
                },
                {
                    "scid": "c402ff50-3e76-11e2-a25f-0800200c0343",
                    "requestedstats": [
                        "OverallTestKills",
                        "TestHeadshots"
                    ]
                }
            ] 
}
      
```

## HTTP 状態コード

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

\| コード | 理由句 | 説明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 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}
{    
   "users":[          
       {    
	  "xuid": "123456789"
        "gamertag": "WarriorSaint",
        "scids":[
          {
             "scid":"c402ff50-3e76-11e2-a25f-0800200c1212",
             "stats":  [
		  {
		         "statname":"Test4FirefightKills",
		         "type":"Integer",
		         "value":7
             },
		  {
		         "statname":"Test4FirefightHeadshots",
		         "type":"Integer",
		         "value":4
             }]
                        },
          {
             "scid":"c402ff50-3e76-11e2-a25f-0800200c0343",
             "stats":  [
		  {
		         "statname":"OverallTestKills",
		         "type":"Integer",
		         "value":3434
             },
		  {
		         "statname":"TestHeadshots",
		         "type":"Integer",
		         "value":41
             }]
          }],
                   },
    {    
                   "gamertag":"TigerShark",
                   "xuid":1234567890123234
        "scids":[
          {
             "scid":"123456789",
             "stats":  [
		  {
		         "statname":"Test4FirefightKills",
		         "type":"Integer",
		         "value":63
             },
		  {
		         "statname":"Test4FirefightHeadshots",
		         "type":"Integer",
		         "value":12
             }]
                        },
          {
"scid":"987654321",
             "stats":  [
		  {
		         "statname":"OverallTestKills",
		         "type":"Integer",
		         "value":375
             },
		  {
		         "statname":"TestHeadshots",
		         "type":"Integer",
		         "value":34
             }]
          }],
                   }]
}
         
```

## 関連項目

##### 親

[/batch](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/userstats/uri-batch)


## Related topics

- [XblUserStatisticsGetMultipleUserStatisticsAsync](https://devdocs.xbox.com/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsasync.md)
- [XblUserStatisticsGetMultipleUserStatisticsForMultipleServiceConfigurationsAsync](https://devdocs.xbox.com/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsformultipleserviceconfigurationsasync.md)