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.
Enthält Informationen zur Anwesenheit eines Benutzers, einschließlich seiner Verfügbarkeit und Benutzeraktivität.
Diese Ressource unterstützt das Abonnieren von Änderungsbenachrichtigungen.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| Anwesenheit abrufen | presence | Rufen Sie die Anwesenheitsinformationen eines Benutzers ab. |
| Anwesenheit für mehrere Benutzer abrufen | Sammlung Anwesenheit | Rufen Sie die Anwesenheitsinformationen für mehrere Benutzer ab. |
| Anwesenheit festlegen | Legen Sie den Verfügbarkeits- und Aktivitätsstatus in einer Anwesenheitssitzung einer Anwendung für einen Benutzer fest. | |
| Anwesenheit löschen | Löscht eine Anwesenheitssitzung einer Anwendung für einen Benutzer. | |
| Bevorzugte Anwesenheit für einen Benutzer festlegen | Legen Sie die bevorzugte Verfügbarkeit und den Aktivitätsstatus für einen Benutzer fest. | |
| Bevorzugte Anwesenheit für einen Benutzer löschen | Löschen Sie die bevorzugte Verfügbarkeit und den Aktivitätsstatus für einen Benutzer. | |
| Benutzerstatusmeldung festlegen | Legen Sie eine Anwesenheitsstatusmeldung für einen Benutzer fest. | |
| Automatischen Speicherort festlegen | Keine | Aktualisieren des automatischen Arbeitsorts für einen Benutzer. |
| Manuellen Speicherort festlegen | Keine | Legen Sie das manuelle Arbeitsortsignal für einen Benutzer fest. |
| Automatischen Speicherort löschen | Keine | Automatisches Arbeitsortsignal für einen Benutzer löschen. |
| Speicherort löschen | Keine | Löschen Sie die Arbeitsortsignale für einen Benutzer, einschließlich der manuellen und automatischen Ebenen für das aktuelle Datum. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| Aktivität | Zeichenfolge | Die zusätzlichen Informationen zur Verfügbarkeit eines Benutzers. Mögliche Werte sind available, away, beRightBack, busy, doNotDisturb, offline, , outOfOffice. presenceUnknown |
| availability | Zeichenfolge | Die grundlegenden Anwesenheitsinformationen für einen Benutzer. Mögliche Werte sind available, away, beRightBack, busy, presentingdoNotDisturbofflinefocusinginACallinAMeeting. presenceUnknown |
| id | String | Der eindeutige Bezeichner des Benutzers. |
| outOfOfficeSettings | outOfOfficeSettings | Die Abwesenheitseinstellungen für einen Benutzer. |
| sequenceNumber | Zeichenfolge | Der lexikographisch sortierbare Zeichenfolgenstempel, der die Version eines Anwesenheitsobjekts darstellt. |
| statusMessage | presenceStatusMessage | Die Anwesenheitsstatusmeldung eines Benutzers. |
| workLocation | userWorkLocation | Stellt den aggregierten Arbeitsortstatus des Benutzers dar. |
Hinweis
- Weitere Informationen zu den verschiedenen Anwesenheitsstatus finden Sie unter Anwesenheit von Benutzern in Teams.
- Weitere Informationen zu Anwesenheitssitzungen, Statusmutationen, Timeouts und vertrauenswürdigen Domänen finden Sie unter Verwalten des Anwesenheitsstatus mithilfe der Microsoft Graph-API.
Beziehungen
Keine.
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"activity": "String",
"availability": "String",
"id": "String (identifier)",
"outOfOfficeSettings": {"@odata.type": "#microsoft.graph.outOfOfficeSettings"},
"sequenceNumber": "String",
"statusMessage": {"@odata.type": "#microsoft.graph.presenceStatusMessage"},
"workLocation": {"@odata.type": "microsoft.graph.userWorkLocation" }
}