다음을 통해 공유

GET (/users/me/groups/{moniker} )

  • 아티클

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

설명

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

URI 매개 변수

매개 변수 형식 설명
moniker 문자열 사용자 그룹을 정의하는 문자열입니다. 유일하게 허용되는 이름은 대문자 'P'로 시작하는 "People"입니다.

쿼리 문자열 매개 변수

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

권한 부여

사용된 권한 부여 클레임 클레임 유형 필수? 예제 값
Xuid 64비트 부호 있는 정수 예 1234567890

리소스에 대한 개인 정보 설정의 영향

요청 자체가 올바른 형식이면 서비스는 항상 200 OK를 반환합니다. 개인 정보 보호 검사를 통과하지 않는 경우 응답에서 정보를 필터링합니다.

리소스에 대한 개인 정보 설정의 영향 요청 사용자 대상 사용자의 개인 정보 설정 동작
나 - 설명과 같습니다.
친구 모두 설명과 같습니다.
친구 친구만 설명과 같습니다.
친구 차단 설명과 같습니다. 서비스가 데이터를 필터링합니다.
친구가 아닌 사용자 모두 설명과 같습니다.
친구가 아닌 사용자 친구만 설명과 같습니다. 서비스가 데이터를 필터링합니다.
친구가 아닌 사용자 차단 설명과 같습니다. 서비스가 데이터를 필터링합니다.
타사 사이트 모두 설명과 같습니다. 서비스가 데이터를 필터링합니다.
타사 사이트 친구만 설명과 같습니다. 서비스가 데이터를 필터링합니다.
타사 사이트 차단 설명과 같습니다. 서비스가 데이터를 필터링합니다.

필수 요청 헤더

헤더 형식 설명
Authorization 문자열 HTTP 인증을 위한 인증 자격 증명입니다. 예제 값: "XBL3.0 x=<userhash>;<token>".
x-xbl-contract-version 문자열 이 요청을 연결해야 하는 Xbox LIVE 서비스의 이름/번호를 작성합니다. 헤더의 유효성과 권한 부여 토큰의 클레임 등을 확인한 이후에만 요청이 해당 서비스로 라우팅됩니다. 예제 값: 3, vnext.
수락 문자열 허용 가능한 콘텐츠-유형입니다. 프레즌스가 지원하는 대상은 application/json이지만 계속 헤더에 지정되어야 합니다.
Accept-Language 문자열 응답의 문자열에 사용할 수 있는 로캘입니다. 예제 값: en-US.
Host 문자열 서버의 도메인 이름입니다. 예제 값: userpresence.xboxlive.com.

선택적 요청 헤더

헤더 형식 설명
X-RequestedServiceVersion 이 요청을 연결해야 하는 Xbox LIVE 서비스의 이름/번호를 작성합니다. 헤더의 유효성과 권한 부여 토큰의 클레임 등을 확인한 이후에만 요청이 해당 서비스로 라우팅됩니다. 기본값: 1.

요청 본문

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

HTTP 상태 코드

서비스는 이 리소스에서 이 메서드를 통해 수행한 요청에 대한 응답으로 이 섹션의 상태 코드 중 하나를 반환합니다. Xbox Live 서비스에서 사용되는 표준 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 문자열 이 요청을 연결해야 하는 Xbox LIVE 서비스의 이름/번호를 작성합니다. 헤더의 유효성과 권한 부여 토큰의 클레임 등을 확인한 이후에만 요청이 해당 서비스로 라우팅됩니다. 예제 값: 1, vnext.
콘텐츠-종류 문자열 요청 본문의 mime 유형입니다. 예제 값: application/json.
Cache-Control 문자열 캐싱 동작을 지정하는 형식적인 요청입니다. 예제 값: "no-cache".
X-XblCorrelationId 문자열 서버가 반환하는 대상과 클라이언트가 수신한 대상을 연결하는 서비스 생성 값입니다. 예제 값: "4106d0bc-1cb3-47bd-83fd-57d041c6febe".
X-Content-Type-Option 문자열 SDL 호환 값을 반환합니다. 예제 값: "nosniff".
날짜 문자열 메시지를 보낸 날짜/시간입니다. 예제 값: "Tue, 17 Nov 2012 10:33:31 GMT".

선택적 응답 헤더

헤더 형식 설명
Retry-After 문자열 503 HTTP 오류가 반환되었습니다. 클라이언트가 호출을 다시 시도하기 전 대기 시간을 알 수 있습니다. 예제 값: "120".
Content-Length 문자열 응답 본문의 길이. 예제 값: "527".
Content-Encoding 문자열 응답의 인코딩 유형. 예제 값: "gzip".

응답 본문

이 API는 요청의 각 XUID에 대해 PresenceRecord 개체의 배열을 반환합니다.

샘플 응답

[
     {
         xuid:"0123456789",
         state:"online",
         devices:
         [
             {
                 type:"D",
                 titles:
                 [
                     {
                         id:"12341234",
                         name:"Contoso 5",
                         lastModified:"2012-09-17T07:15:23.4930000",
                         placement:"full",
                         state:"active",
                         activity:
                         {
                             richPresence:"Playing on Nirvana"
                         },
                     }
                 ]
             }
         ]
     },
     {
         xuid:"0123456780",
         state:"online",
         devices:
         [
             {
                 type:"D",
                 titles:
                 [
                     {
                         id:"12341235",
                         name:"Contoso Waypoint",
                         lastModified:"2012-09-17T07:15:23.4930000",
                         placement;"full",
                         state:"active",
                         activity:
                         {
                             richPresence:"Viewing stats"
                         },
                     }
                 ]
             }
         ]
     },
     {
         xuid:"0123456781",
         state:"online",
         devices:
         [
             {
                 type:"Win8",
                 titles:
                 [
                     {
                         id:"23452345",
                         name:"Contoso Gamehelp",
                         state:"active",
                         timestamp:"2012-09-17T07:15:23.4930000",
                         activity:
                         {
                             richPresence:"Viewing help"
                         }
                     }
                 ]
             }
         ]
     }
 ]

참고 항목

부모

/users/me/groups/{moniker}