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