Skip to main content

GET (/users/xuid()/groups//broadcasting )

URI에 나타나는 XUID와 관련된 그룹 모니커로 지정된 방송 중인 사용자의 프레즌스 레코드를 검색합니다. 이러한 URI의 도메인은 userpresence.xboxlive.com입니다.

설명

URI에 나타나는 XUID와 관련된 그룹 모니커로 지정된 방송 중인 사용자의 프레즌스 레코드에 액세스합니다.

URI 매개 변수

쿼리 문자열 매개 변수

| 매개 변수| 형식| 설명| | --- | --- | --- | --- | --- | --- | | level| string| 이 쿼리 문자열로 지정된 세부 수준을 반환합니다. 유효한 옵션은 “user”, “device”, “title”, “all”입니다. “user” 수준은 중첩된 DeviceRecord 개체가 없는 PresenceRecord 개체입니다. “device” 수준은 중첩된 TitleRecord 개체가 없는 PresenceRecord 및 DeviceRecord 개체입니다. “title” 수준은 중첩된 ActivityRecord 개체가 없는 PresenceRecord, DeviceRecord 및 TitleRecord 개체입니다. “all” 수준은 모든 중첩된 개체를 포함한 전체 레코드입니다. 이 매개 변수를 제공하지 않으면 서비스는 기본적으로 title 수준으로 설정됩니다(즉, 이 사용자의 프레즌스를 타이틀의 세부 정보까지 반환).|

권한 부여

사용되는 권한 부여 클레임 | 클레임| 형식| 필수 여부| 예제 값| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Xuid| 64비트 부호 있는 정수| 예| 1234567890|

개인 정보 설정이 리소스에 미치는 영향

요청 자체가 올바른 형식이면 서비스는 항상 200 OK를 반환합니다. 그러나 개인 정보 검사를 통과하지 못하면 응답에서 정보를 필터링합니다. 개인 정보 설정이 리소스에 미치는 영향 | 요청 사용자| 대상 사용자의 개인 정보 설정| 동작| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | me| -| 설명한 대로.| | friend| everyone| 설명한 대로.| | friend| friends only| 설명한 대로.| | friend| blocked| 설명한 대로 - 서비스가 데이터를 필터링합니다.| | non-friend user| everyone| 설명한 대로.| | non-friend user| friends only| 설명한 대로 - 서비스가 데이터를 필터링합니다.| | non-friend user| blocked| 설명한 대로 - 서비스가 데이터를 필터링합니다.| | third-party site| everyone| 설명한 대로 - 서비스가 데이터를 필터링합니다.| | third-party site| friends only| 설명한 대로 - 서비스가 데이터를 필터링합니다.| | third-party site| blocked| 설명한 대로 - 서비스가 데이터를 필터링합니다.|

필수 요청 헤더

| 헤더| 형식| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| string| HTTP 인증을 위한 인증 자격 증명입니다. 예제 값: “XBL3.0 x=<userhash>;<token>”.| | x-xbl-contract-version| string| 이 요청이 라우팅되어야 하는 XBOX LIVE 서비스의 빌드 이름/번호입니다. 요청은 헤더의 유효성, 인증 토큰의 클레임 등을 확인한 후에만 해당 서비스로 라우팅됩니다. 예제 값: 3, vnext.| | Accept| string| 허용되는 콘텐츠 형식입니다. Presence가 지원하는 유일한 형식은 application/json이지만 헤더에 반드시 지정해야 합니다.| | Accept-Language| string| 응답의 문자열에 허용되는 로캘입니다. 예제 값: en-US.| | Host| string| 서버의 도메인 이름입니다. 예제 값: userpresence.xboxlive.com.|

선택적 요청 헤더

| 헤더| 형식| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| | 이 요청이 라우팅되어야 하는 XBOX LIVE 서비스의 빌드 이름/번호입니다. 요청은 헤더의 유효성, 인증 토큰의 클레임 등을 확인한 후에만 해당 서비스로 라우팅됩니다. 기본값: 1.|

요청 본문

이 요청의 본문에는 개체가 전송되지 않습니다.

HTTP 상태 코드

서비스는 이 리소스에서 이 메서드로 이루어진 요청에 대한 응답으로 이 섹션의 상태 코드 중 하나를 반환합니다. XBOX Live Services에서 사용되는 표준 HTTP 상태 코드의 전체 목록은 표준 HTTP 상태 코드를 참조하십시오. | 코드| 이유 구문| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK| 세션을 성공적으로 검색했습니다.| | 400| Bad Request| 서비스가 잘못된 형식의 요청을 이해할 수 없습니다. 일반적으로 잘못된 매개 변수입니다.| | 401| Unauthorized| 요청에 사용자 인증이 필요합니다.| | 403| Forbidden| 사용자 또는 서비스에 요청이 허용되지 않습니다.| | 404| Not Found| 지정된 리소스를 찾을 수 없습니다.| | 405| Method Not Allowed| 지원되지 않는 콘텐츠 형식에 HTTP 메서드가 사용되었습니다.| | 406| Not Acceptable| 리소스 버전이 지원되지 않습니다.| | 500| Request Timeout| 서비스가 잘못된 형식의 요청을 이해할 수 없습니다. 일반적으로 잘못된 매개 변수입니다.| | 503| Request Timeout| 서비스가 잘못된 형식의 요청을 이해할 수 없습니다. 일반적으로 잘못된 매개 변수입니다.|

필수 응답 헤더

| 헤더| 형식| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | x-xbl-contract-version| string| 이 요청이 라우팅되어야 하는 XBOX LIVE 서비스의 빌드 이름/번호입니다. 요청은 헤더의 유효성, 인증 토큰의 클레임 등을 확인한 후에만 해당 서비스로 라우팅됩니다. 예제 값: 1, vnext.| | Content-Type| string| 요청 본문의 MIME 형식입니다. 예제 값: application/json.| | Cache-Control| string| 캐싱 동작을 지정하는 요청입니다. 예제 값: “no-cache”.| | X-XblCorrelationId| string| 서버가 반환하는 값과 클라이언트가 수신하는 값을 상관 관계로 연결하기 위해 서비스에서 생성한 값입니다. 예제 값: “4106d0bc-1cb3-47bd-83fd-57d041c6febe”.| | X-Content-Type-Option| string| SDL 호환 값을 반환합니다. 예제 값: “nosniff”.| | Date| string| 메시지가 전송된 날짜/시간입니다. 예제 값: “Tue, 17 Nov 2012 10:33:31 GMT”.|

선택적 응답 헤더

| 헤더| 형식| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Retry-After| string| 503 HTTP 오류에서 반환됩니다. 호출을 재시도하기 전에 대기해야 할 시간을 클라이언트에 알립니다. 예제 값: “120”.| | Content-Length| string| 응답 본문의 길이입니다. 예제 값: “527”.| | Content-Encoding| string| 응답의 인코딩 형식입니다. 예제 값: “gzip”.|

응답 본문

이 API는 URI에 나타나는 XUID와 관련된 그룹 모니커로 지정된 방송 중인 사용자의 프레즌스 레코드를 검색합니다.

샘플 응답

함께 보기

상위
/users/xuid()/groups/
Last modified on October 19, 2026