Упражнение — получение доступа к информации пользователей из Microsoft Graph с помощью песочницы Graph

  • 8 мин

В следующем упражнении вы познакомитесь с песочницей Graph и просмотрите ключевые API Microsoft Graph, которые может вызывать ваше приложение.

Начало работы с песочницей Graph

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

  1. Посетите веб-сайт песочницы Graph.
  2. В разделе Примеры запросов слева выберите любой API Microsoft Graph.
  3. Выбранный запрос автоматически выполняется в песочнице Graph. Обратите внимание на URL-адрес API, который вы выбрали для тестирования.
  4. После успешного выполнения запроса вы получите уведомление ОК — 200.
  5. Результат запроса отображается в разделе Предварительный просмотр отклика.

Снимок экрана, на котором показан процесс получения профиля пользователя.

Тестовые запросы с собственной учетной записью в песочнице Graph

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

По умолчанию в песочнице Graph используются примеры данных учетной записи. Чтобы протестировать запросы, которые получают собственные данные, можно выполнить вход с помощью своей учетной записи. Тест можно выполнить с помощью функции проверки подлинности в песочнице Graph.

Примечание.

Убедитесь, что клиент разработчика Microsoft 365 создан. Это одно из необходимых условий для этого модуля.

  1. Нажмите кнопку Войти в песочницу Graph слева, войдите в с учетной записью клиента разработчика Microsoft 365, а затем выберите Принять, чтобы предоставить согласие на запрашиваемые разрешения в песочнице Graph.

    После входа слева появится информация о вашем профиле.

  2. Выберите из примеров запросов GET элементы, популярные в моей компании.

  3. Вы получаете предупреждение, которое означает, что API Microsoft Graph для анализа требует некоторых разрешений для выполнения запроса.

  4. Выберите Изменить разрешения. Необходимые разрешения отображаются для выбранного запроса.

  5. Выберите Согласие, чтобы предоставить согласие для каждого разрешения.

    Снимок экрана, на котором показано, как тестировать запросы с собственной учетной записью в песочнице Graph.

  6. Выберите Выполнить запрос.

  7. После запуска аналитики API вы получите сообщениеОК — 200.

  8. В результате на вкладке Предварительный просмотр вы увидите популярные элементы.

    Снимок экрана, на котором показано, как получить результат запроса с собственной учетной записью в песочнице Graph.

Попробуйте выполнить запрос POST в песочнице Graph.

Каждый раз, когда новый продавец добавляется в канал отдела продаж в Teams, вы можете автоматизировать отправку сообщения в канал, чтобы поприветствовать нового продавца. Чтобы отправить сообщение в канал в Microsoft Teams, можно использовать запрос POST в песочнице Graph:

  1. Выберите POST в раскрывающемся списке HTTP-команды.

  2. Найдите "Команды" в разделе "Примеры запросов".

  3. Выберите Сообщение канала отправки POST в раскрывающемся списке Microsoft Teams.

  4. Вы увидите всплывающую подсказку о том, что вам понадобятся идентификатор группы и идентификатор канала для этого запроса. Кроме того, рекомендуется запустить GET моих команд и GET канала команды, участником которой я являюсь, чтобы получить необходимый ИД команды и ИД канала.

    Снимок экрана с запросом POST в песочнице Microsoft Graph.

  5. Получив ИД команды и ИД канала, отредактируете запрос с помощью редактора запросов. Замените {team-id} и {channel-id} своими идентификаторами.

  6. Предоставьте согласие на получение необходимых разрешений на вкладке Изменить разрешения.

  7. В тексте запроса существует содержимое по умолчанию, такое как "Hello world". Это сообщение, которое вы отправите на свой канал в Microsoft Teams. Вы можете изменить содержимое текста запроса любым предложением, которое вы предпочитаете отправить.

  8. Нажмите Выполнить запрос, чтобы выполнить запрос.

  9. После успешного завершения запроса вы увидите сообщение Создано – 201.

    Снимок экрана с результатом запроса POST в песочнице Microsoft Graph.

  10. Чтобы просмотреть результаты, перейдите в https://teams.microsoft.com и выберите Teams в левом меню. Найдите команду и канал, выбранные для отправки сообщения, и выберите название канала. Вы увидите сообщение "Hello world", отправленное вами в канале Публикации:

    Снимок экрана с результатом запроса публикации в Microsoft Teams.

Используйте Microsoft Graph в приложениях с помощью песочницы Graph

В песочнице Graph есть другие функции, которые помогут подключить приложения к Microsoft Graph:

  1. Маркер доступа: Интерфейсы API Microsoft Graph используют маркеры доступа, чтобы установить удостоверение пользователя, а также выполнить проверку подлинности и авторизацию. На вкладке Маркер доступа можно скопировать собственный маркер доступа или проверки подлинности.

  2. Фрагменты кода: если вы тестируете любой запрос Microsoft Graph в песочнице Graph и хотите использовать тот же запрос в своем приложении, вы можете перейти на вкладку Фрагменты кода, чтобы получить связанный код для добавления в свое приложение. Фрагменты кода доступны на C#, JavaScript, Java и Objective-C для всех примеров запросов.

  3. Компонент Toolkit: компоненты Microsoft Graph Toolkit — это веб-компоненты, не привязанные к какой-либо платформе и помогающие вам получить доступ к Microsoft Graph. Вы можете использовать вкладку компонент Toolkit, чтобы протестировать эти компоненты HTML и использовать их в веб-приложениях для получения данных Microsoft 365 с помощью Microsoft Graph. Когда вы запускаете запрос и для него доступен компонент Toolkit, в правой части вкладки появляется синяя точка.

  4. Адаптивные карточки: адаптивные карточки — это компоненты пользовательского интерфейса, которые не привязаны к какой-либо платформе и используются в ботах. Если вы хотите использовать Microsoft Graph в чат-ботах, например в примере бота календаря, приведенном ранее, вы можете использовать вкладку Адаптивные карточки, чтобы получить фрагмент кода пользовательского интерфейса. Если вы запускаете запрос и для него доступна адаптивная карточка, в правой части вкладки появляется синяя точка.

    Снимок экрана, на котором показано, как использовать Microsoft Graph в приложениях с помощью песочницы Graph.

Песочница Graph — это постоянно развивающийся инструмент с множеством функций, которые помогают облегчить обучение и практику для пользователей, которые открывают для себя функции Microsoft Graph.