> ## 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 - 获取丰富状态信息、媒体信息或二者</li></ul>默认值为 “title”。 |
| onlineOnly | 布尔值 | 如果此属性为 true,批处理操作将过滤掉离线用户的记录(包括隐身用户)。如果未提供,则同时返回在线和离线用户。 |

## JSON 语法示例

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


```

## 另请参阅

##### 父主题

[JavaScript 对象表示法 (JSON) 对象参考](https://docs.xbox.com/zh-CN/reference/live/rest/json/atoc-xboxlivews-reference-json.md)

##### 参考


## Related topics

- [JavaScript 对象表示法 (JSON) 对象参考](https://docs.xbox.com/zh-CN/reference/live/rest/json/atoc-xboxlivews-reference-json.md)
- [PermissionCheckBatchRequest (JSON)](https://docs.xbox.com/zh-CN/reference/live/rest/json/json-permissioncheckbatchrequest.md)
- [/batch](https://docs.xbox.com/zh-CN/reference/live/rest/uri/userstats/uri-batch.md)
- [POST (/json/users/batch/scids/{scid}/data/{pathAndFileName},json)](https://docs.xbox.com/zh-CN/reference/live/rest/uri/storage/uri-jsonusersbatchscidssciddatapathandfilenametype-post.md)
- [PermissionCheckBatchResponse (JSON)](https://docs.xbox.com/zh-CN/reference/live/rest/json/json-permissioncheckbatchresponse.md)