Тип ресурса activityHistoryItem

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

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

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

Методы

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

Свойства

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

Связи

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

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

В следующем представлении JSON показан тип ресурса.

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