presence : clearUserPreferredPresence
Espace de noms: microsoft.graph
Effacez les status de disponibilité et d’activité par défaut pour un utilisateur.
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.ReadWrite | Non disponible. |
Déléguée (compte Microsoft personnel) | Non prise en charge. | Non prise en charge. |
Application | Presence.ReadWrite.All | Non disponible. |
Requête HTTP
POST /users/{userId}/presence/clearUserPreferredPresence
En-têtes de demande
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 vide pour cette méthode.
Réponse
Si elle réussit, cette méthode renvoie un code de réponse 200 OK
.
Exemples
Demande
L’exemple suivant montre une requête qui efface la disponibilité et l’activité préférées status pour un utilisateur.
POST https://graph.microsoft.com/v1.0/users/fa8bf3dc-eca7-46b7-bad1-db199b62afc3/presence/clearUserPreferredPresence
Réponse
L’exemple suivant illustre la réponse.
HTTP/1.1 200 OK