> ## 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 パラメーター

| Parameter | Type | Description |
| - | - | - |
| userId | string | 'xuid(12345)'、'gt(myGamertag)'、または 'me' のいずれかを指定できます。 |
| userList | string | 設定を取得する対象となる、名前付きの人物リスト。現在サポートされているリストは People のみです。 |

## クエリ文字列パラメーター

\| Parameter| Type| Description|
\| --- | --- | --- | --- | --- | --- |
\| settings| string| 設定名のカンマ区切りリスト。|

## 必須リクエスト ヘッダー

\| Header| Type| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| x-xbl-contract-version| 32-bit signed integer| 値 = 2|
\| content-type| string| 値 = `application/json`|

## リクエスト本文

### リクエスト例

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

##### レスポンス本文

レスポンスは **ReadMultiSettingsResponseV2** オブジェクトです。呼び出し元ユーザーにフレンドが 1 人だけいると仮定した場合:

```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/ja-jp/reference/live/rest/uri/profileV2/uri-usersuseridprofilesettingspeopleuserlist)

[Profile (JSON)](https://devdocs.xbox.com/ja-jp/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)