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

# 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://devdocs.xbox.com/zh-CN/reference/live/rest/json/atoc-xboxlivews-reference-json)

##### 参考


## Related topics

- [Reputation overview](https://devdocs.xbox.com/services/xbox-services/community/reputation/live-reputation-overview.md)
- [Items and Inventory Overview](https://devdocs.xbox.com/services/playfab/economy-monetization/economy-v2/inventory/items-and-inventory-overview.md)
- [Test Account tool (XblTestAccountGui.exe)](https://devdocs.xbox.com/tools/tools-services/live-xbox-live-account-tool.md)
- [XBOX Texture Compressor (XBTC) tool reference](https://devdocs.xbox.com/build/core-features/graphics/newfeatures/xbtc/index.md)
- [PFEventPipelineCreateTelemetryPipelineHandleWithEntity](https://devdocs.xbox.com/services/playfab/api-references/c/pfeventpipeline/functions/pfeventpipelinecreatetelemetrypipelinehandlewithentity.md)