tipo de recurso historyItem
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 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 |
---|---|---|
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 historyItem se someterá a eliminación rígida. El cliente puede establecerlo. |
id | Cadena | Obligatorio. GUID de conjunto de cliente para el objeto historyItem . |
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. |
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ó historyItem (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 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"
}
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de