POST (/users/batch)
Obtient la présence d’un lot d’utilisateurs. Le domaine de ces URI estuserpresence.xboxlive.com.
- Remarques
- Autorisation
- Effet des paramètres de confidentialité sur la ressource
- En-têtes de requête obligatoires
- En-têtes de requête facultatifs
- Corps de la requête
- Corps de la réponse
Remarques
Cette méthode doit être utilisée par tout client, service ou titre souhaitant obtenir des informations de présence pour un lot d’utilisateurs. Les réponses à cette requête par lot peuvent être filtrées par profondeur et par chemin. Les consommateurs peuvent s’en servir pour connaître et afficher la présence d’un ensemble d’utilisateurs. Les filtres de cette API fonctionnent comme des OU au sein d’une propriété, mais comme des ET entre les propriétés.Autorisation
Effet des paramètres de confidentialité sur la ressource
Cette méthode retourne toujours 200 OK, mais peut ne pas retourner de contenu dans le corps de la réponse. | Utilisateur demandeur| Paramètre de confidentialité de l’utilisateur cible| Comportement| | --- | --- | --- | --- | --- | --- | --- | | moi| -| 200 OK| | ami| tout le monde| 200 OK| | ami| amis uniquement| 200 OK| | ami| bloqué| 200 OK| | utilisateur non ami| tout le monde| 200 OK| | utilisateur non ami| amis uniquement| 200 OK| | utilisateur non ami| bloqué| 200 OK| | site tiers| tout le monde| 200 OK| | site tiers| amis uniquement| 200 OK| | site tiers| bloqué| 200 OK|En-têtes de requête obligatoires
| En-tête| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| string| Informations d’identification pour l’authentification HTTP. Exemple de valeur : “XBL3.0 x=<userhash>;<token>”.| | x-xbl-contract-version| string| Nom/numéro de build du service XBOX LIVE vers lequel cette requête doit être dirigée. La requête n’est acheminée vers ce service qu’après vérification de la validité de l’en-tête, des revendications du jeton d’authentification, etc. Exemples de valeurs : 3, vnext.| | Accept| string| Types de contenu (Content-Types) acceptables. Le seul pris en charge par Presence est application/json, mais il doit être spécifié dans l’en-tête.| | Accept-Language| string| Paramètres régionaux acceptables pour les chaînes de la réponse. Exemples de valeurs : en-US.| | Host| string| Nom de domaine du serveur. Exemple de valeur : presencebeta.xboxlive.com.| | Content-Length| string| Longueur du corps de la requête. Exemple de valeur : 312.|En-têtes de requête facultatifs
| En-tête| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| | Nom/numéro de build du service XBOX LIVE vers lequel cette requête doit être dirigée. La requête n’est acheminée vers ce service qu’après vérification de la validité de l’en-tête, des revendications du jeton d’authentification, etc. Valeur par défaut : 1.|Corps de la requête
Membres obligatoires
| Membre| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | users| Liste des XUID des utilisateurs dont vous souhaitez connaître la présence, avec un maximum de 1100 XUID à la fois.|Membres facultatifs
| Membre| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | deviceTypes| Liste des types d’appareils utilisés par les utilisateurs qui vous intéressent. Si le tableau est laissé vide, il prend par défaut tous les types d’appareils possibles (c’est-à-dire qu’aucun n’est exclu par filtrage).| | titles| Liste des types d’appareils dont les utilisateurs vous intéressent. Si le tableau est laissé vide, il prend par défaut tous les titres possibles (c’est-à-dire qu’aucun n’est exclu par filtrage).| | level| Valeurs possibles :- user : obtient les nœuds utilisateur
- device : obtient les nœuds utilisateur et appareil
- title : obtient les informations de base au niveau du titre
- all : obtient les informations Rich Presence, les informations multimédias, ou les deux
La valeur par défaut est “title”.| | onlineOnly| Si cette propriété a la valeur true, l’opération par lot exclut les enregistrements des utilisateurs hors connexion (y compris ceux qui sont masqués). Si elle n’est pas fournie, les utilisateurs en ligne et hors connexion sont retournés.|
