Тип ресурса activityHistoryItem

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

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

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

Методы

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

Свойства

Имя	Тип	Описание
activeDurationSeconds	int	Необязательный параметр. Длительность активного взаимодействия с пользователем. Если этот параметр не указан, он вычисляется из значений startedDateTime и lastActiveDateTime.
createdDateTime	DateTimeOffset	Задается сервером. DateTime в формате UTC, когда объект был создан на сервере.
expirationDateTime	DateTimeOffset	Необязательный параметр. Дата и время в формате UTC, когда действиеHistoryItem будет подвергнуто жесткому удалению. Может быть задано клиентом.
id	String	Обязательный. Идентификатор GUID, заданный клиентом для объекта activityHistoryItem .
lastActiveDateTime	DateTimeOffset	Необязательный параметр. Дата и время в формате UTC, когда activityHistoryItem (сеанс действия) в последний раз понимался как активный или завершенный. Если значение NULL, состояние activityHistoryItem должно быть текущим .
lastModifiedDateTime	DateTimeOffset	Задается сервером. DateTime в формате UTC, когда объект был изменен на сервере.
startedDateTime	DateTimeOffset	Обязательное. Дата и время в формате UTC, когда был запущен activityHistoryItem (сеанс действия). Требуется для журнала временной шкалы.
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"
}