> ## 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.

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

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

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

取得一或多位使用者的設定檔。
這些 URI 的網域為 `profile.xboxlive.com`。

* [備註](#ID4EV)
* [授權](#ID4EFB)
* [必要的要求標頭](#ID4EOB)
* [要求本文](#ID4EZC)
* [回應本文](#ID4EJD)

<a id="ID4EV" />

## 備註

這是  中唯一允許的完整 Profile URL。來自用戶端的所有其他 Profile API 都會遭到封鎖。

<a id="ID4EFB" />

## 授權

若要存取設定檔，只需要一般的驗證權杖和宣告。

<a id="ID4EOB" />

## 必要的要求標頭

| 標頭 | 類型 | 描述 |
| - | - | - |
| x-xbl-contract-version | 32 位元不帶正負號的整數 | 合約版本必須設為 2，以便將此呼叫與 XBOX 360 API 區分開來。 |
| content-type | 字串 | 值 = <code>application/json</code> |

<a id="ID4EZC" />

## 要求本文

<a id="ID4E6C" />

### 範例要求

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

<a id="ID4EJD" />

## 回應本文

<a id="ID4EPD" />

### 範例回應

```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"
               }
            ]
         }
      ]
   }
         
```

<a id="ID4EZD" />

## 另請參閱

<a id="ID4E2D" />

##### 上層

[/users/batch/profile/settings](/zh-TW/reference/live/rest/uri/profileV2/uri-usersbatchprofilesettings)

<a id="ID4EFE" />

##### 參考

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


## Related topics

- [XblProfileGetUserProfileAsync](/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofileasync.md)
- [XblProfileGetUserProfilesAsync](/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesasync.md)