Тип ресурса historyItem

Статья
03/15/2023

Пространство имен: microsoft.graph

Представляет элемент журнала для действия в приложении. Действия пользователей представляют собой одно назначение в приложении; например, телешоу, документ или текущую кампанию в видеоигре. Когда пользователь участвует в этом действии, задействование записывается как элемент журнала, указывающий время начала и окончания этого действия. По мере того как пользователь повторно взаимодействует с этим действием с течением времени, для одного действия пользователя записываются несколько элементов журнала.

Когда приложение создает сеанс, к объекту действия следует добавить объект historyItem, чтобы отразить период взаимодействия с пользователем. Каждый раз, когда пользователь повторно участвует в действии, в действие добавляется новый объект historyItem для привлечения пользователей.

Методы

Метод	Возвращаемый тип	Описание
Создание или замена historyItem	historyItem	Создайте или замените существующий объект historyItem для этого действия (upsert). Идентификатор должен быть GUID.
Удаление элемента historyItem	Содержимое отсутствует	Удалите указанный объект historyItem для этого действия.

Свойства

Имя	Тип	Описание
activeDurationSeconds	int	Необязательный параметр. Длительность активного взаимодействия с пользователем. Если этот параметр не указан, он вычисляется из значений startedDateTime и lastActiveDateTime.
createdDateTime	DateTimeOffset	Задается сервером. DateTime в формате UTC, когда объект был создан на сервере.
expirationDateTime	DateTimeOffset	Необязательный параметр. Utc DateTime, когда объект historyItem будет подвергнутся жесткому удалению. Может быть задано клиентом.
id	String	Обязательный. Идентификатор GUID, заданный клиентом для объекта historyItem .
lastActiveDateTime	DateTimeOffset	Необязательный параметр. ВРЕМЯ UTC DateTime, когда historyItem (сеанс действия) в последний раз понимался как активный или завершенный. Если значение null, состояние historyItem должно быть текущим .
lastModifiedDateTime	DateTimeOffset	Задается сервером. DateTime в формате UTC, когда объект был изменен на сервере.
startedDateTime	DateTimeOffset	Обязательное. Дата и время в формате UTC, когда был запущен объект historyItem (сеанс действия). Требуется для временная шкала журнала.
status	status	Задается сервером. Код состояния, используемый для идентификации допустимых объектов. Значения: активные, обновленные, удаленные, игнорируемые.
userTimezone	String	Необязательный параметр. Часовой пояс, в котором устройство пользователя, используемое для создания действия, находилось во время создания действия. Значения, предоставляемые в виде идентификаторов Olson для поддержки кроссплатформенного представления.

Связи

Связь	Тип	Описание
действие	userActivity	Необязательный параметр. NavigationProperty/Containment; свойство навигации для связанного действия.

Представление JSON

Ниже указано представление ресурса в формате JSON.

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