Тип ресурса 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"
}