> ## 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/{userId}/profile/settings/people/{userList})

> GET (/users/{userId}/profile/settings/people/{userList})

# GET (/users/{userId}/profile/settings/people/{userList})

People 모니커를 지원하는 사용자 또는 사용자들의 프로필을 가져옵니다.
이러한 URI의 도메인은 `profile.xboxlive.com`입니다.

* [설명](#ID4EV)
* [URI 매개 변수](#ID4EKB)
* [쿼리 문자열 매개 변수](#ID4EVB)
* [필수 요청 헤더](#ID4EQC)
* [요청 본문](#ID4E2D)

## 설명

**userList**와 **userIds**는 상호 배타적인 매개 변수입니다. 둘 다 또는 둘 중 하나라도 지정하면 **BadRequest**를 반환합니다. **userList**는 여러 명명된 목록을 요청하는 것이 유용한 시나리오를 위한 미래 대비용 배열입니다. **userIds**는 XUID에 대한 10진수 문자열로 구성됩니다 - JSON은 64비트 부호 없는 정수의 직렬화에 적합하지 않습니다. 마지막으로 XBOX One의 설정은 64비트 부호 없는 정수나 **XONLINE\_PROFILE\_ASDF** 같은 불명확한 상수가 아니라, 사람이 읽을 수 있는 일반적인 이름의 명명된 설정이 됩니다.

## URI 매개 변수

| 매개 변수 | 형식 | 설명 |
| - | - | - |
| userId | string | 'xuid(12345)', 'gt(myGamertag)' 또는 'me' 중 하나일 수 있습니다. |
| userList | string | 설정을 가져올 명명된 사용자 목록입니다. 현재 지원되는 유일한 목록은 People입니다. |

## 쿼리 문자열 매개 변수

\| 매개 변수| 형식| 설명|
\| --- | --- | --- | --- | --- | --- |
\| settings| string| 설정 이름의 쉼표로 구분된 목록입니다.|

## 필수 요청 헤더

\| 헤더| 형식| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| x-xbl-contract-version| 32비트 부호 있는 정수| 값 = 2|
\| content-type| string| 값 = `application/json`|

## 요청 본문

### 샘플 요청

```cpp theme={null}
GET /users/me/profile/settings/people/people?settings=GameDisplayName,GameDisplayPicRaw,Gamerscore,Gamertag
      
```

##### 응답 본문

응답은 **ReadMultiSettingsResponseV2** 개체입니다. 호출하는 사용자에게 친구가 한 명만 있다고 가정합니다.

```cpp theme={null}
{
      "profileUsers":[
         {
            "id":"2533274791381930",
            "settings":[
               {
                  "id":"GameDisplayName",
                  "value":"John Smith"
               },
               {
                  "id":"GameDisplayPicRaw",
                  "value":"http://images-eds.xboxlive.com/image?url=z951ykn43p4FqWbbFvR2Ec.8vbDhj8G2Xe7JngaTToBrrCmIEEXHC9UNrdJ6P7KIN0gxC2r1YECCd3mf2w1FDdmFCpSokJWa2z7xtVrlzOyVSc6pPRdWEXmYtpS2xE4F&format=png&w=64&h=64"
               },
               {
                  "id":"Gamerscore",
                  "value":"0"
               },
               {
                  "id":"Gamertag",
                  "value":"CracklierJewel9"
               }
            ]
         }
      ]
   }
         
```

## 함께 보기

##### 상위

[/users/{userId}/profile/settings/people/{userList}?settings={settings}](https://devdocs.xbox.com/ko/reference/live/rest/uri/profileV2/uri-usersuseridprofilesettingspeopleuserlist.md)

[Profile (JSON)](https://devdocs.xbox.com/ko/reference/live/rest/json/json-profile.md)


## Related topics

- [/users/{userId}/profile/settings/people/{userList}?settings={settings}](https://devdocs.xbox.com/ko/reference/live/rest/uri/profileV2/uri-usersuseridprofilesettingspeopleuserlist.md)
- [GET (/users/{ownerId}/people/mute)](https://devdocs.xbox.com/ko/reference/live/rest/uri/privacy/uri-privacyusersowneridpeoplemuteget.md)
- [GET (/users/{ownerId}/people/avoid)](https://devdocs.xbox.com/ko/reference/live/rest/uri/privacy/uri-privacyusersxuidpeopleavoidget.md)
- [GET (/users/{ownerId}/people/{targetid})](https://devdocs.xbox.com/ko/reference/live/rest/uri/people/uri-usersowneridpeopletargetidget.md)
- [XblProfileGetUserProfilesForSocialGroupAsync](https://devdocs.xbox.com/ko/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupasync.md)