Tipo de recurso activityHistoryItem

Espacio de nombres: microsoft.graph

Representa un elemento de historial para una actividad en una aplicación. Las actividades del usuario representan un único destino dentro de la aplicación; por ejemplo, un programa de televisión, un documento o una campaña actual en un videojuego. Cuando un usuario se involucra con esa actividad, la interacción se captura como un elemento de historial que indica la hora de inicio y finalización de esa actividad. A medida que el usuario vuelve a interactuar con esa actividad a lo largo del tiempo, se registran varios elementos del historial para una sola actividad de usuario.

Cuando una aplicación crea una sesión, se debe agregar un objeto activityHistoryItem al objeto de actividad para reflejar el período de interacción del usuario. Cada vez que un usuario vuelve a interactuar con una actividad, se agrega una nueva actividadHistoryItem a la actividad para acumular la interacción del usuario.

Métodos

Método	Tipo de valor devuelto	Descripción
Crear o reemplazar un elemento de historial	activityHistoryItem	Cree o reemplace una actividad existenteHistoryItem para esa actividad (upsert). El identificador debe ser un GUID.
Eliminar un elemento de historial	Sin contenido	Elimine el objeto activityHistoryItem especificado para esa actividad.

Propiedades

Nombre	Tipo	Descripción
activeDurationSeconds	Entero	Opcional. Duración de la interacción activa del usuario. si no se proporciona, se calcula a partir de startedDateTime y lastActiveDateTime.
createdDateTime	DateTimeOffset	Establecido por el servidor. DateTime en UTC cuando se creó el objeto en el servidor.
expirationDateTime	DateTimeOffset	Opcional. Utc DateTime cuando activityHistoryItem se someterá a eliminación rígida. El cliente puede establecerlo.
id	Cadena	Obligatorio. GUID de conjunto de cliente para el objeto activityHistoryItem .
lastActiveDateTime	DateTimeOffset	Opcional. Utc DateTime cuando la activityHistoryItem (sesión de actividad) se entendió por última vez como activa o finalizada: si es null, el estado activityHistoryItem debe ser Continuo.
lastModifiedDateTime	DateTimeOffset	Establecido por el servidor. DateTime en UTC cuando se modificó el objeto en el servidor.
startedDateTime	DateTimeOffset	Necesario. Utc DateTime cuando se inició activityHistoryItem (sesión de actividad). Necesario para el historial de escala de tiempo.
status	status	Establecido por el servidor. Código de estado que se usa para identificar objetos válidos. Valores: activos, actualizados, eliminados, omitidos.
userTimezone	Cadena	Opcional. La zona horaria en la que se encontraba el dispositivo del usuario para generar la actividad en el momento de la creación de la actividad. Valores proporcionados como identificadores de Olson para admitir la representación multiplataforma.

Relaciones

Relación	Tipo	Descripción
actividad	userActivity	Opcional. NavigationProperty/Contención; propiedad navigation a la actividad asociada.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

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