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


```

## 함께 보기

##### 상위

[JSON(JavaScript Object Notation) 개체 참조](https://docs.xbox.com/ko/reference/live/rest/json/atoc-xboxlivews-reference-json.md)

##### 참조


## Related topics

- [JSON(JavaScript Object Notation) 개체 참조](https://docs.xbox.com/ko/reference/live/rest/json/atoc-xboxlivews-reference-json.md)
- [PermissionCheckBatchRequest (JSON)](https://docs.xbox.com/ko/reference/live/rest/json/json-permissioncheckbatchrequest.md)
- [/batch](https://docs.xbox.com/ko/reference/live/rest/uri/userstats/uri-batch.md)
- [POST (/json/users/batch/scids/{scid}/data/{pathAndFileName},json)](https://docs.xbox.com/ko/reference/live/rest/uri/storage/uri-jsonusersbatchscidssciddatapathandfilenametype-post.md)
- [PermissionCheckBatchResponse (JSON)](https://docs.xbox.com/ko/reference/live/rest/json/json-permissioncheckbatchresponse.md)