activityHistoryItem-Ressourcentyp
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.
Stellt ein Verlaufselement für eine Aktivität in einer App dar. Benutzeraktivitäten stellen ein einzelnes Ziel innerhalb Ihrer App dar. Beispielsweise eine Fernsehsendung, ein Dokument oder eine aktuelle Kampagne in einem Videospiel. Wenn sich ein Benutzer mit dieser Aktivität beschäftigt, wird die Interaktion als Verlaufselement erfasst, das die Start- und Endzeit für diese Aktivität angibt. Wenn sich der Benutzer im Laufe der Zeit erneut mit dieser Aktivität beschäftigt, werden mehrere Verlaufselemente für eine einzelne Benutzeraktivität aufgezeichnet.
Wenn eine App eine Sitzung erstellt, sollte dem Aktivitätsobjekt ein activityHistoryItem-Objekt hinzugefügt werden, um den Zeitraum der Benutzerbindung widerzuspiegeln. Jedes Mal, wenn sich ein Benutzer erneut mit einer Aktivität beschäftigt, wird der Aktivität ein neues activityHistoryItem hinzugefügt, um die Benutzerbindung zu steigern.
Methoden
Methode | Rückgabetyp | Beschreibung |
---|---|---|
Verlaufselement erstellen oder ersetzen | activityHistoryItem | Create oder ersetzen Sie ein vorhandenes activityHistoryItem-Objekt für diese Aktivität (Upsert). Die ID muss eine GUID sein. |
Verlaufselement löschen | Kein Inhalt | Löschen Sie das angegebene activityHistoryItem-Objekt für diese Aktivität. |
Eigenschaften
Name | Typ | Beschreibung |
---|---|---|
status | Zeichenfolge | Wird vom Server festgelegt. Ein status Code, der zum Identifizieren gültiger Objekte verwendet wird. Werte: aktiv, aktualisiert, gelöscht, ignoriert. |
userTimezone | Zeichenfolge | Optional. Die Zeitzone, in der sich das Gerät des Benutzers zum Generieren der Aktivität zum Zeitpunkt der Aktivitätserstellung befand. Werte, die als Olson-IDs angegeben werden, um die plattformübergreifende Darstellung zu unterstützen. |
createdDateTime | DateTimeOffset | Wird vom Server festgelegt. DateTime in UTC, wenn das Objekt auf dem Server erstellt wurde. |
lastModifiedDateTime | DateTimeOffset | Wird vom Server festgelegt. DateTime in UTC, wenn das Objekt auf dem Server geändert wurde. |
id | Zeichenfolge | Erforderlich. Clientsatz-GUID für das activityHistoryItem-Objekt . |
startedDateTime | DateTimeOffset | Erforderlich. UTC DateTime, wenn das activityHistoryItem (Aktivitätssitzung) gestartet wurde. Erforderlich für Zeitleiste Verlauf. |
lastActiveDateTime | DateTimeOffset | Optional. UTC DateTime, wenn das activityHistoryItem (Aktivitätssitzung) zuletzt als aktiv oder beendet verstanden wurde– wenn null, sollte activityHistoryItem status Fortlaufend sein. |
expirationDateTime | DateTimeOffset | Optional. UTC DateTime, wenn das activityHistoryItem-Objekt endgültig gelöscht wird. Kann vom Client festgelegt werden. |
activeDurationSeconds | int | Optional. Die Dauer der aktiven Benutzerbindung. Wenn nicht angegeben, wird dies aus startedDateTime und lastActiveDateTime berechnet. |
Beziehungen
Beziehung | Typ | Beschreibung |
---|---|---|
Aktivität | userActivity | Optional. NavigationProperty/Containment; Navigationseigenschaft für die zugeordnete Aktivität. |
JSON-Darstellung
Es folgt eine JSON-Darstellung der Ressource.
{
"activeDurationSeconds":"int",
"createdDateTime": "DateTimeOffset",
"expirationDateTime": "DateTimeOffset",
"id": "String",
"lastActiveDateTime": "DateTimeOffset",
"lastModifiedDateTime": "DateTimeOffset",
"startedDateTime": "DateTimeOffset",
"status": "String",
"userTimezone": "String"
}
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