presence: setUserPreferredPresence
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta
Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Legen Sie die bevorzugte Verfügbarkeit und Aktivität status für einen Benutzer fest. Wenn die bevorzugte Anwesenheit eines Benutzers festgelegt ist, ist die Anwesenheit des Benutzers die bevorzugte Anwesenheit.
Die bevorzugte Anwesenheit wird nur wirksam, wenn mindestens eine Anwesenheitssitzung des Benutzers vorhanden ist. Andernfalls bleibt die Anwesenheit des Benutzers offline.
Eine Anwesenheitssitzung kann als Ergebnis eines erfolgreichen setPresence-Vorgangs oder erstellt werden, wenn der Benutzer bei einem Teams-Client angemeldet ist.
Erfahren Sie mehr über Anwesenheitssitzungen und deren Timeout und Ablauf.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | Presence.ReadWrite | Nicht verfügbar. |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | Presence.ReadWrite.All | Nicht verfügbar. |
HTTP-Anforderung
POST /users/{userId}/presence/setUserPreferredPresence
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Content-Type | application/json. Erforderlich. |
Anforderungstext
Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.
Parameter | Typ | Beschreibung |
---|---|---|
availability | string | Die Basis-Anwesenheitsinformationen. |
Aktivität | string | Die zusätzlichen Informationen zur Verfügbarkeit. |
expirationDuration | Dauer | Der Ablauf der App-Anwesenheitssitzung. Der Wert wird für die Dauer im ISO 8601-Format dargestellt. Wenn keine Angabe erfolgt, wird ein Standardablauf angewendet: DoNotDisturb oder Busy: läuft in 1 Tag ab Alle anderen: läuft in 7 Tagen ab |
Unterstützte Kombinationen von Verfügbarkeit und Aktivität sind:
availability | Aktivität | Beschreibung |
---|---|---|
Verfügbar | Verfügbar | Legen Sie den bevorzugten Anwesenheitsnamen des Benutzers auf Verfügbar fest. |
Gebucht | Gebucht | Legen Sie den bevorzugten Anwesenheitsnamen des Benutzers auf Beschäftigt fest. |
DoNotDisturb | DoNotDisturb | Legen Sie die bevorzugte Anwesenheit des Benutzers auf DoNotDisturb fest. |
BeRightBack | BeRightBack | Legen Sie die vom Benutzer bevorzugte Anwesenheit auf BeRightBack fest. |
Weg | Weg | Legen Sie die bevorzugte Anwesenheit des Benutzers auf Weg fest. |
Offline | OffWork | Legen Sie die bevorzugte Anwesenheit des Benutzers auf Offline fest. |
Antwort
Wenn die Methode erfolgreich verläuft, wird der Antwortcode 200 OK
zurückgegeben.
Beispiele
Die folgende Anforderung legt die vom Benutzer bevorzugte Anwesenheit als DoNotDisturb für den Benutzer fa8bf3dc-eca7-46b7-bad1-db199b62afc3
fest, wobei der Ablauf 8 Stunden beträgt.
Anforderung
POST https://graph.microsoft.com/beta/users/fa8bf3dc-eca7-46b7-bad1-db199b62afc3/presence/setUserPreferredPresence
Content-Type: application/json
{
"availability": "DoNotDisturb",
"activity": "DoNotDisturb",
"expirationDuration": "PT8H"
}
Antwort
HTTP/1.1 200 OK
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für