tipo de recurso historyItem

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

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 historyItem 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 un nuevo objeto historyItem a la actividad para acumular la participación del usuario.

Métodos

Método	Tipo de valor devuelto	Descripción
Crear o reemplazar historyItem	historyItem	Cree o reemplace un objeto historyItem existente para esa actividad (upsert). El identificador debe ser un GUID.
Eliminación de un objeto historyItem	Sin contenido	Elimine el objeto historyItem especificado para esa actividad.

Propiedades

Nombre	Tipo	Descripción
status	cadena	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.
createdDateTime	DateTimeOffset	Establecido por el servidor. DateTime en UTC cuando se creó el objeto en el servidor.
lastModifiedDateTime	DateTimeOffset	Establecido por el servidor. DateTime en UTC cuando se modificó el objeto en el servidor.
id	Cadena	Obligatorio. GUID de conjunto de cliente para el objeto historyItem .
startedDateTime	DateTimeOffset	Necesario. Utc DateTime cuando se inició historyItem (sesión de actividad). Necesario para el historial de escala de tiempo.
lastActiveDateTime	DateTimeOffset	Opcional. Utc DateTime cuando el historyItem (sesión de actividad) se entendió por última vez como activo o finalizado: si es null, el estado historyItem debe ser En curso.
expirationDateTime	DateTimeOffset	Opcional. Utc DateTime cuando historyItem se someterá a eliminación rígida. El cliente puede establecerlo.
activeDurationSeconds	Entero	Opcional. Duración de la interacción activa del usuario. si no se proporciona, se calcula a partir de startedDateTime y lastActiveDateTime.

Relaciones

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

Representación JSON

La siguiente es una representación JSON del recurso

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