> ## 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. # GET (/users/xuid({xuid})/groups/{moniker} ) > GET (/users/xuid({xuid})/groups/{moniker} ) # GET (/users/xuid({xuid})/groups/{moniker} ) 그룹의 PresenceRecord를 가져옵니다. 이러한 URI의 도메인은 `userpresence.xboxlive.com`입니다. * [설명](#ID4EV) * [URI 매개 변수](#ID4E5) * [쿼리 문자열 매개 변수](#ID4EJB) * [권한 부여](#ID4EKC) * [개인 정보 설정이 리소스에 미치는 영향](#ID4EQD) * [필수 요청 헤더](#ID4EEH) * [선택적 요청 헤더](#ID4EMBAC) * [요청 본문](#ID4EMCAC) * [HTTP 상태 코드](#ID4EXCAC) * [필수 응답 헤더](#ID4E3GAC) * [선택적 응답 헤더](#ID4EMJAC) * [응답 본문](#ID4E5KAC) ## 설명 URI의 사용자와 관련된 모니커로 지정된 그룹의 사용자를 검색하고 해당 사용자의 PresenceRecord를 반환합니다. 개인 정보 또는 콘텐츠 격리로 제한된 데이터는 반환되지 않습니다. ## URI 매개 변수 | 매개 변수 | 형식 | 설명 | | - | - | - | | xuid | string | 그룹의 XUID와 관련된 사용자의 XBOX 사용자 ID(XUID)입니다. | | moniker | string | 사용자 그룹을 정의하는 문자열입니다. 현재 허용되는 유일한 모니커는 대문자 'P'로 시작하는 "People"입니다. | ## 쿼리 문자열 매개 변수 \| 매개 변수| 형식| 설명| \| --- | --- | --- | --- | --- | --- | \| 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=\;\".| \| 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 상태 코드](https://devdocs.xbox.com/ko/reference/live/rest/additional/httpstatuscodes)를 참조하십시오. \| 코드| 이유 구문| 설명| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | \| 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 개체의 배열을 반환합니다. ### 샘플 응답 ```cpp theme={null} [ { 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/xuid({xuid})/groups/{moniker}](https://devdocs.xbox.com/ko/reference/live/rest/uri/presence/uri-usersxuidgroupsmoniker) ## Related topics - [XblUserStatisticsGetSingleUserStatisticAsync](https://devdocs.xbox.com/ja-jp/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticasync.md) - [XblUserStatisticsGetSingleUserStatisticsAsync](https://devdocs.xbox.com/ja-jp/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsasync.md)