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

# BatchRequest (JSON)

> BatchRequest (JSON)

# BatchRequest (JSON)

用於篩選線上狀態資訊的屬性陣列，例如使用者、裝置和遊戲。

## BatchRequest

BatchRequest 物件具有下列規格。

| 成員 | 類型 | 描述 |
| - | - | - |
| users | string 陣列 | 列出您想要了解其線上狀態之使用者的 XUID，一次最多 1100 個 XUID。 |
| deviceTypes | string 陣列 | 您想要了解之使用者所使用的裝置類型清單。如果陣列保留空白，預設為所有可能的裝置類型 (也就是不篩選掉任何類型)。 |
| titles | 32 位元不帶正負號整數陣列 | 您想要了解其使用者的裝置類型清單。如果陣列保留空白，預設為所有可能的遊戲 (也就是不篩選掉任何遊戲)。 |
| level | string | 可能的值：<ul><li>user - 取得使用者節點</li><li>device - 取得使用者和裝置節點</li><li>title - 取得基本遊戲層級資訊</li><li>all - 取得 Rich Presence 資訊、媒體資訊或兩者</li></ul>預設值為 "title"。 |
| onlineOnly | 布林值 | 如果此屬性為 true，批次作業會篩選掉離線使用者 (包括隱身使用者) 的記錄。如果未提供，則會同時傳回線上和離線使用者。 |

## JSON 語法範例

```json theme={null}
{
  users:
  [
    "1234567890",
    "4567890123",
    "7890123456"
  ]
}


```

## 另請參閱

##### 上層

[JavaScript 物件標記法 (JSON) 物件參考](https://docs.xbox.com/zh-TW/reference/live/rest/json/atoc-xboxlivews-reference-json.md)

##### 參考


## Related topics

- [JavaScript 物件標記法 (JSON) 物件參考](https://docs.xbox.com/zh-TW/reference/live/rest/json/atoc-xboxlivews-reference-json.md)
- [PermissionCheckBatchRequest (JSON)](https://docs.xbox.com/zh-TW/reference/live/rest/json/json-permissioncheckbatchrequest.md)
- [/batch](https://docs.xbox.com/zh-TW/reference/live/rest/uri/userstats/uri-batch.md)
- [POST (/json/users/batch/scids/{scid}/data/{pathAndFileName},json)](https://docs.xbox.com/zh-TW/reference/live/rest/uri/storage/uri-jsonusersbatchscidssciddatapathandfilenametype-post.md)
- [PermissionCheckBatchResponse (JSON)](https://docs.xbox.com/zh-TW/reference/live/rest/json/json-permissioncheckbatchresponse.md)