> ## 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 Moniker。
這些 URI 的網域為 `profile.xboxlive.com`。

* [備註](#ID4EV)
* [URI 參數](#ID4EKB)
* [查詢字串參數](#ID4EVB)
* [必要的要求標頭](#ID4EQC)
* [要求本文](#ID4E2D)

<a id="ID4EV" />

## 備註

**userList** 和 **userIds** 是互斥的參數。如果兩者都指定或指定其中之一，您會收到 **BadRequest**。**userList** 是一個陣列，以因應未來在需要要求多個具名清單的案例。**userIds** 由 XUID 的十進位字串組成，因為 JSON 不擅長序列化 64 位元不帶正負號的整數。最後，XBOX One 中的設定將會是具名設定，使用一般人類可讀的名稱，而不是 64 位元不帶正負號的整數或 **XONLINE\_PROFILE\_ASDF** 之類難懂的常數。

<a id="ID4EKB" />

## URI 參數

| 參數 | 類型 | 描述 |
| - | - | - |
| userId | 字串 | 可以是 'xuid(12345)'、'gt(myGamertag)' 或 'me'。 |
| userList | 字串 | 要取得其設定的具名人員清單。目前僅支援 People 清單。 |

<a id="ID4EVB" />

## 查詢字串參數

\| 參數| 類型| 描述|
\| --- | --- | --- | --- | --- | --- |
\| settings| 字串| 以逗號分隔的設定名稱清單。|

<a id="ID4EQC" />

## 必要的要求標頭

\| 標頭| 類型| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| x-xbl-contract-version| 32 位元帶正負號的整數| 值 = 2|
\| content-type| 字串| 值 = <code>application/json</code>|

<a id="ID4E2D" />

## 要求本文

<a id="ID4EBE" />

### 範例要求

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

<a id="ID4EKE" />

<a id="ID4EME" />

##### 回應本文

回應是 **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"
               }
            ]
         }
      ]
   }
         
```

<a id="ID4E3E" />

## 另請參閱

<a id="ID4E5E" />

##### 上層

[/users/{userId}/profile/settings/people/{userList}?settings={settings}](/zh-TW/reference/live/rest/uri/profileV2/uri-usersuseridprofilesettingspeopleuserlist)

[Profile (JSON)](/zh-TW/reference/live/rest/json/json-profile)


## Related topics

- [XblProfileGetUserProfilesForSocialGroupAsync](/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupasync.md)
- [Displaying people from the People System](/services/xbox-services/community/people-system/concepts/live-pplsys-displaying-people.md)
- [Guest users overview](/build/core-features/common/user/users-guest-overview.md)
- [访客用户概述](/zh-CN/build/core-features/common/user/users-guest-overview.md)
- [게스트 사용자 개요](/ko/build/core-features/common/user/users-guest-overview.md)