> ## 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})

获取一个或多个用户的个人资料,支持“人员”代号。
这些 URI 的域为 `profile.xboxlive.com`。

* [备注](#ID4EV)
* [URI 参数](#ID4EKB)
* [查询字符串参数](#ID4EVB)
* [必需的请求标头](#ID4EQC)
* [请求正文](#ID4E2D)

## 备注

**userList** 和 **userIds** 是互斥参数。如果同时指定两者或指定其中一个,你将收到 **BadRequest**。**userList** 是数组,以便在将来存在多个命名列表有用的场景中使用。**userIds** 由 XUID 的十进制字符串组成——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/zh-CN/reference/live/rest/uri/profileV2/uri-usersuseridprofilesettingspeopleuserlist)

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


## Related topics

- [XblProfileGetUserProfilesForSocialGroupAsync](https://devdocs.xbox.com/fr/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupasync.md)
- [Guest users overview](https://devdocs.xbox.com/build/core-features/common/user/users-guest-overview.md)