historyItem-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Stellt ein Verlaufselement für eine Aktivität in einer APP dar. Benutzeraktivitäten stellen ein einzelnes Ziel in Ihrer APP dar, beispielsweise eine TV-Sendung, ein Dokument oder eine aktuelle Kampagne in einem Videospiel. Wenn ein Benutzer diese Aktivität einsetzt, wird das Engagement als Verlaufselement erfasst, das die Anfangs-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 Activity -Objekt ein historyItem -Objekt hinzugefügt werden, um den Zeitraum des Benutzer Engagements widerzuspiegeln. Jedes Mal, wenn ein Benutzer eine Aktivität erneut einbindet, wird der Aktivität ein neuer historyItem hinzugefügt, um das Benutzer Engagement aufzunehmen.

Methoden

Methode	Rückgabetyp	Beschreibung
Erstellen oder Ersetzen von historyItem	historyItem	Erstellt oder ersetzt eine vorhandene historyItem für diese Aktivität (Upsert). Die ID muss eine GUID sein.
Löschen eines historyItem	Kein Inhalt	Löscht die angegebene historyItem für diese Aktivität.

Eigenschaften

Name	Typ	Beschreibung
status	Zeichenfolge	Vom Server festgelegt. Ein Statuscode, der zum Identifizieren gültiger Objekte verwendet wird. Werte: aktiv, aktualisiert, gelöscht, ignoriert.
userTimezone	Zeichenfolge	Optional. Die Zeitzone, in der das Gerät des Benutzers zum Generieren der Aktivität zum Zeitpunkt der Erstellung der Aktivität gefunden wurde. Werte, die als Olson-IDs bereitgestellt werden, um die plattformübergreifende Darstellung zu unterstützen.
createdDateTime	DateTimeOffset	Vom Server festgelegt. DateTime in UTC, als das Objekt auf dem Server erstellt wurde.
lastModifiedDateTime	DateTimeOffset	Vom Server festgelegt. DateTime in UTC, wenn das Objekt auf dem Server geändert wurde.
id	String	Erforderlich. Client-legen Sie die GUID für das historyItem -Objekt fest.
startedDateTime	DateTimeOffset	Erforderlich. UTC DateTime, wenn die historyItem (Aktivitäts Sitzung) gestartet wurde. Für Chronik Verlauf erforderlich.
lastActiveDateTime	DateTimeOffset	Optional. UTC DateTime wenn die historyItem (Aktivitäts Sitzung) zuletzt als aktiv oder abgeschlossen (wenn NULL) verstanden wurde, sollte der historyItem -Status fortgesetzt werden.
expirationDateTime	DateTimeOffset	Optional. UTC DateTime, wenn das historyItem -Objekt dem Hard-Delete unterzogen wird. Kann vom Client festgelegt werden.
activeDurationSeconds	int	Optional. Die Dauer des aktiven Benutzer Engagements. Wenn diese nicht angegeben wird, wird dies aus dem startedDateTime und lastActiveDateTimeberechnet.

Beziehungen

Beziehung	Typ	Beschreibung
activity	Kommentaraktivität	Optional. NavigationProperty/Containment; Navigationseigenschaft der zugeordneten Aktivität.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
    "status": "String (EnumType)",
    "createdDateTime": "DateTimeOffset",
    "lastModifiedDateTime": "DateTimeOffset",
    "id": "String",
    "expirationDateTime": "DateTimeOffset",
    "startedDateTime": "DateTimeOffset",
    "userTimezone": "String",
    "lastActiveDateTime": "DateTimeOffset",
    "activeDurationSeconds":"int"
}