type de ressource activityHistoryItem

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 activityHistoryItem 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éengue avec une activité, une nouvelle activitéHistoryItem est ajoutée à l’activité pour accumuler l’engagement de l’utilisateur.

Méthodes

Méthode	Type renvoyé	Description
Créer ou remplacer un élément d’historique	activityHistoryItem	Créez ou remplacez un objet activityHistoryItem existant pour cette activité (upsert). L’ID doit être un GUID.
Supprimer un élément d’historique	Aucun contenu	Supprimez l’objet activityHistoryItem 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 activityHistoryItem subira une suppression définitive. Peut être défini par le client.
id	Chaîne	Obligatoire. GUID défini par le client pour l’objet activityHistoryItem .
lastActiveDateTime	DateTimeOffset	Optional. DateTime UTC lorsque l’objet activityHistoryItem (session d’activité) a été compris pour la dernière fois comme actif ou terminé. Si la valeur est null, l’état activityHistoryItem doit être Ongoing.
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 activityHistoryItem (session d’activité) a été démarré. Requis pour l’historique de chronologie.
status	status	Défini par le serveur. Code d’état 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

La représentation JSON suivante montre le type de ressource.

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