Compartir a través de


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"
}