cloudCommunications : getPresencesByUserId
Espace de noms: microsoft.graph
Obtenez les informations de présence pour plusieurs utilisateurs.
Note: Cette API permet aux utilisateurs de s’abonner uniquement à la présence d’un autre utilisateur. Si une application souhaite s’abonner aux informations de présence de tous les utilisateurs, elle utilise des utilisateurs fictifs pour créer l’abonnement afin de collecter les données requises.
Cette API est disponible dans les déploiements de cloud national suivants.
Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Autorisations
Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.
Type d’autorisation | Autorisations avec privilèges minimum | Autorisations privilégiées plus élevées |
---|---|---|
Déléguée (compte professionnel ou scolaire) | Presence.Read.All | Non disponible. |
Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
Application | Presence.Read.All | Presence.ReadWrite.All |
Remarque :
- Un maximum de 650 ID d’utilisateur sont pris en charge par demande d’API.
- Le taux maximal de requêtes de cette API est de 1 500 demandes d’API sur une période de 30 secondes, par application et par locataire.
Requête HTTP
POST /communications/getPresencesByUserId
En-têtes de requête
Nom | Description |
---|---|
Autorisation | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Content-type | application/json. Obligatoire. |
Corps de la demande
Dans le corps de la demande, fournissez un objet JSON avec le paramètre suivant.
Paramètre | Type | Description |
---|---|---|
Ids | String collection | ID d’objet utilisateur. |
Réponse
Si elle réussit, cette méthode renvoie un 200 OK
code de réponse et une collection d’objets de présence dans le corps de la réponse.
Exemples
Demande
L’exemple suivant illustre une demande.
POST https://graph.microsoft.com/v1.0/communications/getPresencesByUserId
Content-Type: application/json
{
"ids": ["fa8bf3dc-eca7-46b7-bad1-db199b62afc3", "66825e03-7ef5-42da-9069-724602c31f6b"]
}
Réponse
L’exemple suivant illustre la réponse.
Note: Les objets response peuvent être raccourcis pour plus de lisibilité. Toutes les propriétés sont renvoyées à partir d’un appel réel.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1574
{
"value": [{
"id": "fa8bf3dc-eca7-46b7-bad1-db199b62afc3",
"availability": "Busy",
"activity": "InAMeeting"
},
{
"id": "66825e03-7ef5-42da-9069-724602c31f6b",
"availability": "Away",
"activity": "Away"
}
]
}
Contenu connexe
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour