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

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

Важно!

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

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

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

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

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

Методы

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

Свойства

Имя	Тип	Описание
userTimezone	String	Необязательный параметр. Часовой пояс, в котором устройство пользователя, используемое для создания действия, находилось во время создания действия; значения, предоставленные в виде идентификаторов Olson для поддержки кроссплатформенного представления.
createdDateTime	DateTimeOffset	Задается сервером. DateTime в формате UTC, когда объект был создан на сервере.
lastModifiedDateTime	DateTimeOffset	Задается сервером. DateTime в формате UTC, когда объект был изменен на сервере.
id	String	Идентификатор сервера, используемый для адресации URL-адресов.
appActivityId	String	Обязательный. Уникальный идентификатор действия в контексте приложения , предоставленный вызывающим и неизменяемый после этого.
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 требуется отдельный файл и домен.
appDisplayName	String	Необязательный параметр. Краткое текстовое описание приложения, используемого для создания действия для использования в случаях, когда приложение не установлено на локальном устройстве пользователя.
activationUrl	String	Обязательный. URL-адрес, используемый для запуска действия в лучшем собственном интерфейсе, представленном appId. Может запускать веб-приложение, если не существует собственного приложения.
fallbackUrl	String	Необязательный параметр. URL-адрес, используемый для запуска действия в веб-приложении, если он доступен.
contentUrl	String	Необязательный параметр. Используется в случае, если содержимое может быть отрисовано за пределами собственного или веб-интерфейса приложения (например, указатель на элемент в RSS-канале).
visualElements	visualInfo	Обязательно. Объект , содержащий сведения для отрисовки действия в пользовательском интерфейсе.
contentInfo	Нетипизированный объект JSON	Необязательный параметр. Пользовательский фрагмент данных — расширяемое описание содержимого JSON-LD в соответствии с синтаксисом schema.org .
expirationDateTime	DateTimeOffset	Задается сервером. DateTime в формате UTC, когда срок действия объекта истек на сервере.
status	string	Задается сервером. Код состояния, используемый для идентификации допустимых объектов. Значения: активные, обновленные, удаленные, игнорируемые.

Связи

Связь	Тип	Описание
HistoryItems	Коллекция historyItem	Необязательный параметр. 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": "string",
    "contentInfo": { "@data.type": "microsoft.graph.Json" },
    "visualElements": { "@data.type": "microsoft.graph.visualInfo" },
    "historyItems": [{ "@odata.type": "microsoft.graph.historyItem" }]
}