Тип ресурса userActivity

  • Статья

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

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

Вы можете использовать действия в Microsoft Graph, чтобы позволить пользователям вернуться к тому, что они делали в своем приложении, на нескольких устройствах. Действия, создаваемые приложением, отображаются на всех устройствах пользователей и предоставляются пользователям в виде прямых ссылок на определенное содержимое в приложении. Вы можете выразить определенное содержимое в приложении в качестве назначения, которое демонстрируется в Windows и доступно на устройствах iOS и Android с помощью уведомлений Кортаны.

Так как каждое приложение отличается, вы можете понять, как лучше всего сопоставить действия в приложении с действиями пользователей, которые будут отображаться в Кортане и временной шкале. Например, игры могут создавать действия для каждой кампании, приложения для разработки документов могут создавать действия для каждого уникального документа, а бизнес-приложения могут создавать действия для каждого рабочего процесса.

Ваши действия пользователей будут показаны в пользовательском интерфейсе Кортаны и Временной шкалы Windows, которые направлены на повышение производительности и эффективности пользователей, помогая им вернуться к содержимому, над которым они работали ранее.

Методы

Метод Возвращаемый тип Описание
Создание или замена действия userActivity Создает или заменяет существующее действие (upsert). AppActivityId должен быть безопасным по URL-адресу (все символы, кроме rfc 2396 без резервирования, должны быть преобразованы в шестнадцатеричное представление), но исходный идентификатор appActivityId не обязательно должен быть URL-безопасным.
Удаление действия Содержимое отсутствует Удаляет указанное действие для этого пользователя из приложения.
Получение действий Коллекция userActivities Возвращает действия для приложения для данного пользователя.
Получение последних действий Коллекция userActivities Возвращает последние действия для приложения для данного пользователя, отсортированные и основанные на последних созданных или обновленных activityHistoryItems.

Свойства

Имя Тип Описание
activationUrl String Обязательный. URL-адрес, используемый для запуска действия в лучшем собственном интерфейсе, представленном appId. Может запускать веб-приложение, если не существует собственного приложения.
activitySourceHost String Обязательный. URL-адрес домена, представляющего кроссплатформенное сопоставление удостоверений для приложения. Сопоставление хранится в виде JSON-файла, размещенного в домене, или настраивается в Центре разработки для Windows. JSON-файл называется cross-platform-app-identifiers и размещается в корне домена HTTPS либо в домене верхнего уровня, либо включает в себя поддомен. Примеры: https://contoso.com или https://myapp.contoso.com, но НЕ https://myapp.contoso.com/somepath. У вас должен быть уникальный файл и домен (или поддомен) для каждого кроссплатформенного удостоверения приложения. Например, для Word и PowerPoint требуется отдельный файл и домен.
appActivityId String Обязательный. Уникальный идентификатор действия в контексте приложения , предоставленный вызывающим и неизменяемый после этого.
appDisplayName String Необязательный параметр. Краткое текстовое описание приложения, используемого для создания действия для использования в случаях, когда приложение не установлено на локальном устройстве пользователя.
contentInfo Нетипизированный объект JSON Необязательный параметр. Пользовательский фрагмент данных — расширяемое описание содержимого JSON-LD в соответствии с синтаксисом schema.org .
contentUrl String Необязательный параметр. Используется в случае, если содержимое может быть отрисовано за пределами собственного или веб-интерфейса приложения (например, указатель на элемент в RSS-канале).
createdDateTime DateTimeOffset Задается сервером. DateTime в формате UTC, когда объект был создан на сервере.
expirationDateTime DateTimeOffset Задается сервером. DateTime в формате UTC, когда срок действия объекта истек на сервере.
fallbackUrl String Необязательный параметр. URL-адрес, используемый для запуска действия в веб-приложении, если он доступен.
id String Идентификатор сервера, используемый для адресации URL-адресов.
lastModifiedDateTime DateTimeOffset Задается сервером. DateTime в формате UTC, когда объект был изменен на сервере.
status status Задается сервером. Код состояния, используемый для идентификации допустимых объектов. Значения: активные, обновленные, удаленные, игнорируемые.
userTimezone String Необязательный параметр. Часовой пояс, в котором устройство пользователя, используемое для создания действия, находилось во время создания действия; значения, предоставленные в виде идентификаторов Olson для поддержки кроссплатформенного представления.
visualElements visualInfo Обязательно. Объект , содержащий сведения для отрисовки действия в пользовательском интерфейсе.

Связи

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

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

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

{
    "appActivityId": "String",
    "activitySourceHost": "String (host name/domain/URL)",
    "userTimezone": "String",
    "appDisplayName": "String",
    "activationUrl": "String (URL)",
    "contentUrl": "String (URL)",
    "fallbackUrl": "String (URL)",
    "createdDateTime": "DateTimeOffset",
    "lastModifiedDateTime": "DateTimeOffset",
    "expirationDateTime": "DateTimeOffset",
    "id": "String",
    "status": "active | updated | deleted | ignored",
    "contentInfo": { "@odata.type": "microsoft.graph.Json" },
    "visualElements": { "@odata.type": "microsoft.graph.visualInfo" },
    "historyItems": [{ "@odata.type": "microsoft.graph.activityHistoryItem" }]
}