historyItem-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 historyItem-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 historyItem-Element hinzugefügt, um die Benutzerbindung zu steigern.

Methoden

Methode	Rückgabetyp	Beschreibung
Erstellen oder Ersetzen von historyItem	historyItem	Erstellen oder ersetzen Sie ein vorhandenes historyItem-Objekt für diese Aktivität (Upsert). Die ID muss eine GUID sein.
Löschen eines historyItem-Objekts	Kein Inhalt	Löschen Sie das angegebene historyItem-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 historyItem-Objekt .
startedDateTime	DateTimeOffset	Erforderlich. UTC DateTime, wenn das historyItem ( Aktivitätssitzung) gestartet wurde. Erforderlich für Zeitleiste Verlauf.
lastActiveDateTime	DateTimeOffset	Optional. UTC DateTime, wenn das historyItem -Objekt (Aktivitätssitzung) zuletzt als aktiv oder beendet verstanden wurde – wenn null, sollte historyItem status Fortlaufend sein.
expirationDateTime	DateTimeOffset	Optional. UTC DateTime, wenn das historyItem-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"
}