Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 den Aktivitätsstatus 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.
| Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. 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 |
| Application | Presence.ReadWrite.All | Nicht verfügbar. |
HTTP-Anforderung
POST /users/{id}/presence/setUserPreferredPresence
Anforderungsheader
| Name | Beschreibung |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über 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-db199b62afc3fest, 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