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

Obtenir le profil d'un ou de plusieurs utilisateurs, avec prise en charge du moniker People.
Le domaine de ces URI est `profile.xboxlive.com`.

* [Remarques](#ID4EV)
* [Paramètres d'URI](#ID4EKB)
* [Paramètres de chaîne de requête](#ID4EVB)
* [En-têtes de requête obligatoires](#ID4EQC)
* [Corps de la requête](#ID4E2D)

<a id="ID4EV" />

## Remarques

**userList** et **userIds** sont des paramètres mutuellement exclusifs. Si les deux ou l'un ou l'autre sont spécifiés, vous recevrez une réponse **BadRequest**. **userList** est un tableau afin d'assurer la pérennité dans les scénarios où il est utile de demander plusieurs listes nommées. **userIds** est composé de chaînes décimales pour les XUID, car JSON sérialise mal les entiers non signés de 64 bits. Enfin, les paramètres sur XBOX One seront des paramètres nommés, avec des noms normaux lisibles par l'humain, plutôt que des entiers non signés de 64 bits ou des constantes obscures comme **XONLINE\_PROFILE\_ASDF**.

<a id="ID4EKB" />

## Paramètres d'URI

| Paramètre | Type | Description |
| - | - | - |
| userId | chaîne | Peut être 'xuid(12345)', 'gt(myGamertag)' ou 'me'. |
| userList | chaîne | Liste nommée de personnes pour lesquelles obtenir les paramètres. Actuellement, People est la seule liste prise en charge. |

<a id="ID4EVB" />

## Paramètres de chaîne de requête

\| Paramètre| Type| Description|
\| --- | --- | --- | --- | --- | --- |
\| settings| chaîne| Liste de noms de paramètres séparés par des virgules.|

<a id="ID4EQC" />

## En-têtes de requête obligatoires

\| En-tête| Type| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| x-xbl-contract-version| entier signé de 32 bits| Valeur = 2|
\| content-type| chaîne| Valeur = <code>application/json</code>|

<a id="ID4E2D" />

## Corps de la requête

<a id="ID4EBE" />

### Exemple de requête

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

<a id="ID4EKE" />

<a id="ID4EME" />

##### Corps de la réponse

La réponse est un objet **ReadMultiSettingsResponseV2**. En supposant que l'utilisateur appelant n'a qu'un seul ami :

```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" />

## Voir aussi

<a id="ID4E5E" />

##### Parent

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

[Profile (JSON)](/fr-CA/reference/live/rest/json/json-profile)


## Related topics

- [XblProfileGetUserProfilesForSocialGroupAsync](/pt-BR/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupasync.md)
- [Guest users overview](/build/core-features/common/user/users-guest-overview.md)