> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST (/users/batch/profile/settings)

> POST (/users/batch/profile/settings)

# POST (/users/batch/profile/settings)

获取一个或多个用户的个人资料。
这些 URI 的域为 `profile.xboxlive.com`。

* [备注](#ID4EV)
* [授权](#ID4EFB)
* [必需的请求标头](#ID4EOB)
* [请求正文](#ID4EZC)
* [响应正文](#ID4EJD)

## 备注

此为唯一允许的完全限定 Profile URL。来自客户端的所有其他 Profile API 均被阻止。

## 授权

若要访问个人资料,只需正常的身份验证令牌和声明即可。

## 必需的请求标头

| 标头 | 类型 | 说明 |
| - | - | - |
| x-xbl-contract-version | 32 位无符号整数 | 合约版本必须设置为 2,以将此调用与 XBOX 360 API 区分开来。 |
| content-type | string | 值 = `application/json` |

## 请求正文

### 示例请求

```cpp theme={null}
POST /users/batch/profile/settings
   {
      "userIds":[
         "2533274791381930"
       ],
      "settings":[
         "GameDisplayName",
         "GameDisplayPicRaw",
         "Gamerscore",
         "Gamertag"
      ]
   }
      
```

## 响应正文

### 示例响应

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

## 另请参阅

##### 父主题

[/users/batch/profile/settings](https://docs.xbox.com/zh-CN/reference/live/rest/uri/profileV2/uri-usersbatchprofilesettings.md)

##### 参考

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


## Related topics

- [/users/batch/profile/settings](https://docs.xbox.com/zh-CN/reference/live/rest/uri/profileV2/uri-usersbatchprofilesettings.md)
- [POST (/users/batch)](https://docs.xbox.com/zh-CN/reference/live/rest/uri/presence/uri-usersbatchpost.md)
- [/users/{userId}/profile/settings/people/{userList}?settings={settings}](https://docs.xbox.com/zh-CN/reference/live/rest/uri/profileV2/uri-usersuseridprofilesettingspeopleuserlist.md)
- [POST (/untrustedplatform/users/batch/scids/{scid}/data/{pathAndFileName},{type})](https://docs.xbox.com/zh-CN/reference/live/rest/uri/storage/uri-untrustedplatformusersbatchscidssciddatapathandfilenametype-post.md)
- [POST (/json/users/batch/scids/{scid}/data/{pathAndFileName},json)](https://docs.xbox.com/zh-CN/reference/live/rest/uri/storage/uri-jsonusersbatchscidssciddatapathandfilenametype-post.md)