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

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

<a id="ID4EN" />

## 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，批次作業會篩選掉離線使用者 (包括隱身使用者) 的記錄。如果未提供，則會同時傳回線上和離線使用者。 |

<a id="ID4EAD" />

## JSON 語法範例

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


```

<a id="ID4EJD" />

## 另請參閱

<a id="ID4ELD" />

##### 上層

[JavaScript 物件標記法 (JSON) 物件參考](/zh-TW/reference/live/rest/json/atoc-xboxlivews-reference-json)

<a id="ID4EXD" />

##### 參考


## Related topics

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