Skip to main content

GET (/users/me/groups/ )

내 그룹에 대한 PresenceRecord를 가져옵니다. 이러한 URI의 도메인은 userpresence.xboxlive.com입니다.

설명

클레임의 사용자와 관련된 moniker로 지정된 그룹의 사용자를 검색하고 해당 사용자에 대한 PresenceRecord를 반환합니다. 개인 정보 또는 콘텐츠 격리에 의해 차단된 데이터는 단순히 반환되지 않습니다.

URI 매개 변수

쿼리 문자열 매개 변수

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

권한 부여

사용된 권한 부여 클레임 | 클레임| 형식| 필수?| 예시 값| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Xuid| 64-bit signed integer| 예| 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| 허용되는 Content-Types입니다. Presence가 지원하는 유일한 것은 application/json이지만, 여전히 헤더에 지정해야 합니다.| | Accept-Language| string| 응답의 문자열에 허용되는 로캘입니다. 예시 값: en-US.| | Host| string| 서버의 도메인 이름입니다. 예시 값: userpresence.xboxlive.com.|

선택적 요청 헤더

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

요청 본문

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

HTTP 상태 코드

이 리소스에서 이 메서드로 수행한 요청에 대한 응답으로 서비스는 이 섹션의 상태 코드 중 하나를 반환합니다. XBOX Live Services에서 사용되는 표준 HTTP 상태 코드의 전체 목록은 Standard HTTP status codes를 참고하십시오. | 코드| Reason phrase| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 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는 요청의 각 XUID에 대해 하나씩, PresenceRecord 개체의 배열을 반환합니다.

샘플 응답

참고 항목

상위
/users/me/groups/
Last modified on October 19, 2026