Поделиться через

Использование REST API веб-канала действий

  • Статья

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

Вы можете использовать API веб-канала действий в Microsoft Graph, чтобы возобновить действия пользователя на разных устройствах и платформах. Запросы API веб-канала действий выполняются от имени пользователя с помощью делегированных разрешений и разрешений на действия пользователя, которые можно использовать с личными или рабочими и учебными учетными записями.

Действия пользователей представлены ресурсом действий и организованы в веб-канал на основе времени, представленный коллекцией me/activity.

Что делает большую активность пользователей?

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

Что должно стать действием?

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

При определении действий в приложении примените следующие рекомендации.

СДЕЛАЙТЕ: Запишите одно действие для группы связанных действий пользователей. Если приложение используется для последовательности связанного содержимого, вероятно, имеет смысл записать одно действие для всего сеанса взаимодействия.

Сценарии списка воспроизведения: Это особенно актуально для музыкальных списков воспроизведения или телепередач— одно действие пользователя можно обновить, чтобы показать ход выполнения. В этом случае у вас есть одно действие пользователя с несколькими элементами журнала , представляющими периоды взаимодействия в течение нескольких дней или недель.

СДЕЛАЙТЕ: Хранение пользовательских данных в облаке. Если вы хотите поддерживать действия между устройствами, необходимо убедиться, что содержимое, необходимое для повторной регистрации этого действия, хранится в облачном расположении. Например, если вы публикуете действие каждый раз, когда пользователь редактирует документ, документ должен храниться в облаке, а не локально на устройстве пользователя, чтобы включить перезаключение между устройствами.

НЕ НАДО: Создайте действие пользователя для действий, которые пользователям не нужно возобновлять в будущем. Если приложение используется для выполнения простых однократных операций, которые не сохраняют состояние для отслеживания в будущем, вам, вероятно, не нужно писать действия пользователя.

Чтобы было ясно, хотя действия пользователей отображаются на временной шкале Windows, это не средство управления версиями— при выборе действия на основе документа всегда должна отображаться последняя версия этого документа (включая изменения, внесенные другим пользователем).

НЕ НАДО: Создайте действие пользователя для действий, выполненных другими пользователями. Если кто-то отправляет пользователю сообщение или @mentions пользователя в приложении, не следует писать новое действие. Эти взаимодействия лучше обслуживаться всплывая уведомления.

Сценарии совместной работы: Если несколько пользователей работают над одним и тем же действием (например, над документом Word), будут случаи, когда другой пользователь внес изменения в документ после последнего редактирования. В этом случае разработчикам приложений может потребоваться обновить визуальные элементы в действии, чтобы отразить изменения, внесенные в документ. Для этого приложение может обновить существующее действие без создания нового элемента журнала.

Примечание: Если вы публикуете действия для веб-приложения, важно включать и , activationURL и для fallbackURL каждого из ваших действий. Эти действия запустят пользователя обратно в приложение, как и ожидалось из возможностей Майкрософт, таких как Временная шкала Windows.

Шаблоны взаимодействия с приложениями и действия пользователей

Действия пользователей, которые вы создаете, будут отличаться в зависимости от шаблона взаимодействия приложения. Хотя каждое приложение отличается, большинство из них будет попадать в один из следующих шаблонов взаимодействия:

  • Приложения на основе документов . Создайте одно действие на документ с одной или несколькими записями журнала, отражающими периоды использования. Важно обновить действия карта по мере внесения изменений в документ.
  • Приложения для воспроизведения мультимедиа — создайте одно действие для каждой логической группировки содержимого, например списка воспроизведения, программы или автономного содержимого.
  • Игры — создайте одно действие для каждой сохраненной игры или мира. Если ваша игра поддерживает только одну последовательность уровней, вы можете написать одно и то же действие с течением времени, хотя может потребоваться обновить карта, чтобы показать последние ход выполнения или достижения.
  • Служебные приложения . Если в приложении нет ничего, что пользователи хотели бы возобновить, не следует публиковать действия. Хорошим примером является простое одноцеловое приложение, например калькулятор.
  • Бизнес-приложения — существует множество приложений для управления простыми задачами или рабочими процессами. Создайте одно действие для каждого отдельного рабочего процесса, доступ к который осуществляется через приложение. Например, каждый отчет о расходах будет отдельным действием, так как может потребоваться выбрать это действие, чтобы узнать, было ли оно утверждено.

Некоторые сложные приложения включают несколько шаблонов взаимодействия. Вы можете следовать разным шаблонам создания действий пользователей для разных сценариев, обрабатываемых приложением.

Дальнейшие действия

Ищете другие идеи?