> ## 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/me/groups/{moniker} ) > GET (/users/me/groups/{moniker} ) # GET (/users/me/groups/{moniker} ) Obtient le PresenceRecord de mon groupe. Le domaine de ces URI est `userpresence.xboxlive.com`. * [Remarques](#ID4EV) * [Paramètres d'URI](#ID4E5) * [Paramètres de chaîne de requête](#ID4EJB) * [Autorisation](#ID4EKC) * [Effet des paramètres de confidentialité sur la ressource](#ID4EQD) * [En-têtes de requête obligatoires](#ID4EEH) * [En-têtes de requête facultatifs](#ID4EMBAC) * [Corps de la requête](#ID4EMCAC) * [Codes d'état HTTP](#ID4EXCAC) * [En-têtes de réponse obligatoires](#ID4E3GAC) * [En-têtes de réponse facultatifs](#ID4EMJAC) * [Corps de la réponse](#ID4E5KAC) ## Remarques Récupère les utilisateurs du groupe indiqué par le moniker associé à l'utilisateur dans les revendications, et retourne le PresenceRecord de ces utilisateurs. Les données restreintes par la confidentialité ou l'isolation du contenu ne sont tout simplement pas retournées. ## Paramètres d'URI | Paramètre | Type | Description | | - | - | - | | moniker | chaîne | Chaîne définissant le groupe d'utilisateurs. Le seul moniker accepté actuellement est « People » avec un « P » majuscule. | ## Paramètres de chaîne de requête \| Paramètre| Type| Description| \| --- | --- | --- | --- | --- | --- | \| level| chaîne| Retourne le niveau de détail indiqué par cette chaîne de requête. Les options valides sont « user », « device », « title » et « all ». Le niveau « user » correspond à l'objet PresenceRecord sans l'objet imbriqué DeviceRecord. Le niveau « device » correspond aux objets PresenceRecord et DeviceRecord sans l'objet imbriqué TitleRecord. Le niveau « title » correspond aux objets PresenceRecord, DeviceRecord et TitleRecord sans l'objet imbriqué ActivityRecord. Le niveau « all » correspond à l'enregistrement complet, y compris tous les objets imbriqués. Si ce paramètre n'est pas fourni, le service utilise par défaut le niveau title (c'est-à-dire qu'il retourne la présence de cet utilisateur jusqu'aux détails du titre).| ## Autorisation Revendications d'autorisation utilisées | Revendication| Type| Obligatoire?| Exemple de valeur| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | \| Xuid| entier signé de 64 bits| oui| 1234567890| ## Effet des paramètres de confidentialité sur la ressource Le service retournera toujours 200 OK si la requête elle-même est bien formée. Toutefois, il filtrera des renseignements de la réponse lorsque les vérifications de confidentialité échouent. Effet des paramètres de confidentialité sur la ressource | Utilisateur demandeur| Paramètre de confidentialité de l'utilisateur cible| Comportement| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | \| moi| -| Comme décrit.| \| ami| tout le monde| Comme décrit.| \| ami| amis seulement| Comme décrit.| \| ami| bloqué| Comme décrit - le service filtrera les données.| \| utilisateur non ami| tout le monde| Comme décrit.| \| utilisateur non ami| amis seulement| Comme décrit - le service filtrera les données.| \| utilisateur non ami| bloqué| Comme décrit - le service filtrera les données.| \| site tiers| tout le monde| Comme décrit - le service filtrera les données.| \| site tiers| amis seulement| Comme décrit - le service filtrera les données.| \| site tiers| bloqué| Comme décrit - le service filtrera les données.| ## En-têtes de requête obligatoires \| En-tête| Type| Description| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | \| Authorization| chaîne| Informations d'identification pour l'authentification HTTP. Exemple de valeur : "XBL3.0 x=\;\".| \| x-xbl-contract-version| chaîne| Nom ou numéro de build du service XBOX LIVE auquel cette requête doit être dirigée. La requête ne sera acheminée vers ce service qu'après vérification de la validité de l'en-tête, des revendications du jeton d'authentification, et ainsi de suite. Exemples de valeurs : 3, vnext.| \| Accept| chaîne| Types de contenu (Content-Types) acceptables. Le seul pris en charge par Presence est application/json, mais il doit tout de même être indiqué dans l'en-tête.| \| Accept-Language| chaîne| Paramètres régionaux acceptables pour les chaînes de la réponse. Exemple de valeur : en-US.| \| Host| chaîne| Nom de domaine du serveur. Exemple de valeur : userpresence.xboxlive.com.| ## En-têtes de requête facultatifs \| En-tête| Type| Description| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | \| X-RequestedServiceVersion| | Nom ou numéro de build du service XBOX LIVE auquel cette requête doit être dirigée. La requête ne sera acheminée vers ce service qu'après vérification de la validité de l'en-tête, des revendications du jeton d'authentification, et ainsi de suite. Valeur par défaut : 1.| ## Corps de la requête Aucun objet n'est envoyé dans le corps de cette requête. ## Codes d'état HTTP Le service retourne l'un des codes d'état de cette section en réponse à une requête effectuée avec cette méthode sur cette ressource. Pour obtenir la liste complète des codes d'état HTTP standard utilisés avec les services XBOX Live, consultez [Codes d'état HTTP standard](/fr-CA/reference/live/rest/additional/httpstatuscodes). \| Code| Expression de raison| Description| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | \| 200| OK| La session a été récupérée avec succès.| \| 400| Bad Request| Le service n'a pas pu comprendre la requête mal formée. Il s'agit généralement d'un paramètre non valide.| \| 401| Unauthorized| La requête nécessite l'authentification de l'utilisateur.| \| 403| Forbidden| La requête n'est pas autorisée pour l'utilisateur ou le service.| \| 404| Not Found| La ressource indiquée est introuvable.| \| 405| Method Not Allowed| La méthode HTTP a été utilisée sur un type de contenu non pris en charge.| \| 406| Not Acceptable| La version de la ressource n'est pas prise en charge.| \| 500| Request Timeout| Le service n'a pas pu comprendre la requête mal formée. Il s'agit généralement d'un paramètre non valide.| \| 503| Request Timeout| Le service n'a pas pu comprendre la requête mal formée. Il s'agit généralement d'un paramètre non valide.| ## En-têtes de réponse obligatoires \| En-tête| Type| Description| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | \| x-xbl-contract-version| chaîne| Nom ou numéro de build du service XBOX LIVE auquel cette requête doit être dirigée. La requête ne sera acheminée vers ce service qu'après vérification de la validité de l'en-tête, des revendications du jeton d'authentification, et ainsi de suite. Exemples de valeurs : 1, vnext.| \| Content-Type| chaîne| Le type MIME du corps de la requête. Exemple de valeur : application/json.| \| Cache-Control| chaîne| Demande polie visant à préciser le comportement de mise en cache. Exemples de valeurs : "no-cache".| \| X-XblCorrelationId| chaîne| Valeur générée par le service pour mettre en corrélation ce que le serveur retourne et ce que le client reçoit. Exemple de valeur : "4106d0bc-1cb3-47bd-83fd-57d041c6febe".| \| X-Content-Type-Option| chaîne| Retourne la valeur conforme au SDL. Exemple de valeur : "nosniff".| \| Date| chaîne| La date et l'heure d'envoi du message. Exemple de valeur : "Tue, 17 Nov 2012 10:33:31 GMT".| ## En-têtes de réponse facultatifs \| En-tête| Type| Description| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | \| Retry-After| chaîne| Retourné en cas d'erreurs HTTP 503. Indique au client combien de temps attendre avant de réessayer l'appel. Exemples de valeurs : "120".| \| Content-Length| chaîne| Longueur du corps de la réponse. Exemple de valeur : "527".| \| Content-Encoding| chaîne| Type d'encodage de la réponse. Exemple de valeur : "gzip".| ## Corps de la réponse Cette API retourne un tableau d'objets PresenceRecord, un pour chacun des XUID de la requête. ### Exemple de réponse ```cpp theme={null} [ { xuid:"0123456789", state:"online", devices: [ { type:"D", titles: [ { id:"12341234", name:"Contoso 5", lastModified:"2012-09-17T07:15:23.4930000", placement:"full", state:"active", activity: { richPresence:"Playing on Nirvana" }, } ] } ] }, { xuid:"0123456780", state:"online", devices: [ { type:"D", titles: [ { id:"12341235", name:"Contoso Waypoint", lastModified:"2012-09-17T07:15:23.4930000", placement;"full", state:"active", activity: { richPresence:"Viewing stats" }, } ] } ] }, { xuid:"0123456781", state:"online", devices: [ { type:"Win8", titles: [ { id:"23452345", name:"Contoso Gamehelp", state:"active", timestamp:"2012-09-17T07:15:23.4930000", activity: { richPresence:"Viewing help" } } ] } ] } ] ``` ## Voir aussi ##### Parent [/users/me/groups/{moniker}](/fr-CA/reference/live/rest/uri/presence/uri-usersmegroupsmoniker) ## Related topics - [XUserGetAgeGroup](/reference/system/xuser/functions/xusergetagegroup.md) - [XblSocialManagerUserGroupGetUsersTrackedByGroup](/es/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerusergroupgetuserstrackedbygroup.md)