тип ресурса действия

Статья
03/16/2023

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

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

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

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

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

Методы

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

Свойства

Имя	Тип	Описание
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" }]
}