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

POST 方法，針對跨多個遊戲的多個玩家統計資料的複雜批次要求，其作用如同 GET 方法。
這些 URI 的網域為 `userstats.xboxlive.com`。

<a id="ID4ET" />

## 備註

遊戲開發人員可以使用 Partner Center 將統計資料標示為開放或受限制。排行榜是開放的統計資料。只要使用者已獲授權存取沙箱，Smartglass 以及 iOS、Android、Windows、Windows Phone 和 Web 應用程式就可以存取開放的統計資料。使用者對沙箱的授權是透過 Partner Center 管理。

* [備註](#ID4ET)
* [描述](#ID4EFB)
* [授權](#ID4EUB)
* [必要的要求標頭](#ID4ETC)
* [選用的要求標頭](#ID4E3D)
* [要求本文](#ID4EAF)
* [HTTP 狀態碼](#ID4EWF)
* [回應本文](#ID4ENBAC)

<a id="ID4EFB" />

## 描述

呼叫端會提供訊息本文，其中包含使用者陣列、服務設定識別碼 (SCID)，以及每個 SCID 要擷取的統計資料名稱清單。

在閱讀此較複雜的批次模式頁面之前，您可能會發現先檢閱簡單的單一統計資料 [GET](/zh-TW/reference/live/rest/uri/userstats/uri-usersxuidscidsscidstatsget) 方法更有幫助。

<a id="ID4EUB" />

## 授權

針對內容隔離和存取控制案例，已實作授權邏輯。

* 只要呼叫端隨要求提交有效的 XSTS 權杖，任何平台上的用戶端都可以讀取排行榜和使用者統計資料。寫入作業顯然僅限於  支援的用戶端。
* 遊戲開發人員可以使用 Partner Center 將統計資料標示為開放或受限制。排行榜是開放的統計資料。只要使用者已獲授權存取沙箱，Smartglass 以及 iOS、Android、Windows、Windows Phone 和 Web 應用程式就可以存取開放的統計資料。使用者對沙箱的授權是透過 Partner Center 管理。

下列範例是檢查的虛擬程式碼：

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

// else accept request.
         
```

<a id="ID4ETC" />

## 必要的要求標頭

| 標頭 | 類型 | 描述 |
| - | - | - |
| Authorization | string | HTTP 驗證的驗證認證。範例值："XBL3.0 x=\<userhash>;\<token>"。 |

<a id="ID4E3D" />

## 選用的要求標頭

\| 標頭| 類型| 描述|
\| --- | --- | --- | --- | --- | --- |
\| X-RequestedServiceVersion|  | 此要求應導向之服務的組建名稱/編號。只有在驗證標頭的有效性、驗證權杖中的宣告等之後，要求才會路由至該服務。預設值：1。|

<a id="ID4EAF" />

## 要求本文

<a id="ID4EIF" />

### 範例要求

下列 POST 本文會通知服務，正在為兩個不同的使用者從兩個不同的 SCID 要求四項統計資料。

```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"
                    ]
                }
            ] 
}
      
```

<a id="ID4EWF" />

## HTTP 狀態碼

服務會傳回本節中的其中一個狀態碼，以回應在此資源上使用此方法所提出的要求。如需搭配 XBOX Live 服務使用的標準 HTTP 狀態碼完整清單，請參閱[標準 HTTP 狀態碼](/zh-TW/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 層拒絕。|

<a id="ID4ENBAC" />

## 回應本文

<a id="ID4EXBAC" />

### 範例回應

```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
             }]
          }],
                   }]
}
         
```

<a id="ID4EDCAC" />

## 另請參閱

<a id="ID4EFCAC" />

##### 上層

[/batch](/zh-TW/reference/live/rest/uri/userstats/uri-batch)


## Related topics

- [XblUserStatisticsGetMultipleUserStatisticsAsync](/ko/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsasync.md)
- [XblUserStatisticsGetMultipleUserStatisticsForMultipleServiceConfigurationsAsync](/es/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsformultipleserviceconfigurationsasync.md)