Type de ressource historyItem
Espace de noms: microsoft.graph
Représente un élément d’historique pour une activité dans une application. Les activités de l’utilisateur représentent une destination unique au sein de votre application ; par exemple, une émission de télévision, un document ou une campagne en cours dans un jeu vidéo. Lorsqu’un utilisateur s’engage avec cette activité, l’engagement est capturé sous la forme d’un élément d’historique qui indique l’heure de début et de fin de cette activité. À mesure que l’utilisateur se réengager avec cette activité au fil du temps, plusieurs éléments d’historique sont enregistrés pour une seule activité utilisateur.
Lorsqu’une application crée une session, un objet historyItem doit être ajouté à l’objet d’activité pour refléter la période d’engagement de l’utilisateur. Chaque fois qu’un utilisateur se réengager avec une activité, un nouvel objet historyItem est ajouté à l’activité pour accumuler l’engagement de l’utilisateur.
Méthodes
Méthode | Type renvoyé | Description |
---|---|---|
Créer ou remplacer historyItem | historyItem | Créez ou remplacez un objet historyItem existant pour cette activité (upsert). L’ID doit être un GUID. |
Supprimer un objet historyItem | Aucun contenu | Supprimez l’objet historyItem spécifié pour cette activité. |
Propriétés
Nom | Type | Description |
---|---|---|
activeDurationSeconds | int | Optional. Durée de l’engagement de l’utilisateur actif. s’il n’est pas fourni, il est calculé à partir des valeurs startedDateTime et lastActiveDateTime. |
createdDateTime | DateTimeOffset | Défini par le serveur. DateTime au format UTC lorsque l’objet a été créé sur le serveur. |
expirationDateTime | DateTimeOffset | Optional. DateTime UTC lorsque l’objet historyItem sera supprimé de force. Peut être défini par le client. |
id | Chaîne | Obligatoire. GUID défini par le client pour l’objet historyItem . |
lastActiveDateTime | DateTimeOffset | Optional. DateTime UTC lorsque l’objet historyItem (session d’activité) a été compris pour la dernière fois comme actif ou terminé. Si la valeur est null, historyItem status doit être En cours. |
lastModifiedDateTime | DateTimeOffset | Défini par le serveur. DateTime au format UTC lorsque l’objet a été modifié sur le serveur. |
startedDateTime | DateTimeOffset | Obligatoire. DateTime UTC lorsque l’objet historyItem (session d’activité) a démarré. Obligatoire pour l’historique chronologie. |
status | status | Défini par le serveur. Code status utilisé pour identifier les objets valides. Valeurs : actif, mis à jour, supprimé, ignoré. |
userTimezone | String | Facultatif. Fuseau horaire dans lequel l’appareil de l’utilisateur utilisé pour générer l’activité se trouvait au moment de la création de l’activité. Valeurs fournies en tant qu’ID Olson pour prendre en charge la représentation multiplateforme. |
Relations
Relation | Type | Description |
---|---|---|
activité | userActivity | Optional. NavigationProperty/Containment ; propriété de navigation vers l’activité associée. |
Représentation JSON
Voici une représentation JSON de la ressource.
{
"activeDurationSeconds":"int",
"createdDateTime": "DateTimeOffset",
"expirationDateTime": "DateTimeOffset",
"id": "String",
"lastActiveDateTime": "DateTimeOffset",
"lastModifiedDateTime": "DateTimeOffset",
"startedDateTime": "DateTimeOffset",
"status": "String",
"userTimezone": "String"
}
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour