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

Используйте песочницу Graph, чтобы попробовать различные API Microsoft Graph

  • Статья

Graph Обозреватель — это средство разработчика для изучения API Microsoft Graph. Используйте его для перечисленных ниже целей.

  • Протестируйте API-интерфейсы в примере клиента и изучите доступные ресурсы.
  • Войдите в собственный клиент для создания прототипов сценариев приложений.
  • Сведения о разрешениях, необходимых для различных API.
  • Изучите компоненты Microsoft Graph Toolkit, адаптивные карточки и фрагменты кода для запросов.

Чтобы приступить к работе, перейдите в раздел Graph Обозреватель в браузере.

Изучение примера запроса

Вы можете выполнить предварительно созданные примеры запросов, чтобы узнать, как работает API. Выберите любой пример запроса, например Получить мой профиль, чтобы просмотреть запрос и ответ.

Снимок экрана: пользовательский интерфейс Graph Обозреватель, в котором отображаются возвращенные результаты запроса GET my profile.

Вход для получения дополнительных функций

Вы можете использовать Обозреватель Graph без входа. Пользователи, которые входят в систему, могут получать доступ к своим клиентам и выполнять более сложные операции. Чтобы попробовать запросы POST, PUT, PATCH и DELETE, войдите с помощью учетной записи Microsoft 365.

Рекомендуется войти в клиент песочницы разработчика Microsoft 365 , а не в рабочий клиент, чтобы избежать выполнения операций, которые могут повлиять на рабочие данные.

Важно!

Если вы решили войти с помощью учетной записи организации, выполнение любого запроса на запись в Graph Обозреватель может повлиять на данные в клиенте.

Выполнение первого запроса

Чтобы выполнить запрос в Graph Обозреватель, выполните приведенные далее действия.

  1. Выберите пример запроса или введите его в поле запроса.
  2. При необходимости измените текст запроса и заголовки запроса. Например, чтобы выполнить запрос Post, выберите POST в раскрывающемся списке команды HTTP и добавьте текст запроса и заголовки запроса соответствующим образом.
  3. Выберите Выполнить запрос. Ответ отображается в разделе Предварительный просмотр ответа. Он включает код состояния HTTP и данные, возвращаемые API.
  4. Рядом с вкладкой Предварительный просмотр ответа можно также просмотреть заголовки ответов, фрагменты кода, компоненты набора средств и адаптивные карточки, относящиеся к запросу.

Снимок экрана: Обозреватель Graph выполняет запрос POST для создания нового приложения.

Изменение разрешений

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

  1. Выберите изменить разрешения , чтобы предоставить согласие на необходимые разрешения.
  2. Запустите запрос еще раз.
  3. Вы также можете выбрать аватар профиля и выбрать Согласие на разрешения. В списке всех доступных разрешений дайте согласие на те, которые вы хотите.

Снимок экрана: вкладка

Поиск подходящего API для приложения

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

Вкладка "Ресурсы"

Используйте вкладку Ресурсы для просмотра списка ресурсов Microsoft Graph в конечных точках бета-версии и версии 1.0 или с помощью панели поиска для поиска определенного ресурса.

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

Слева показан снимок экрана: вкладка

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

Интеграция API Microsoft Graph в приложение

Используйте следующие функции в Graph Обозреватель для интеграции API Microsoft Graph в приложение.

Фрагменты кода

После выполнения запроса перейдите на вкладку Фрагменты кода , чтобы узнать, как выполнить ту же операцию на предпочитаемом языке (C#, JavaScript, Java, Go, PowerShell).

Снимок экрана: вкладка фрагментов кода в Обозреватель Graph.

Компонент набора средств

Microsoft Graph Toolkit предоставляет многоразовые веб-компоненты и вспомогательные компоненты, не зависящие от платформы, которые имеют встроенные поставщики, которые проходят проверку подлинности с помощью Microsoft Graph и извлекает данные из Microsoft Graph.

Компонент набора средств в Graph Обозреватель позволяет визуализировать компоненты Microsoft Graph Toolkit, соответствующие запросам API. Синяя точка на вкладке компонента набора средств указывает на доступный компонент для текущего запроса REST API. Код компонента удобно скопировать в приложение.

Снимок экрана: вкладка Microsoft Graph Toolkit в Обозреватель Graph.

Адаптивные карточки

Адаптивные карточки предоставляют независимые от платформы фрагменты пользовательского интерфейса, созданные в ФОРМАТЕ JSON, которыми приложения и службы могут открыто обмениваться. Синяя точка на вкладке адаптивных карточек указывает, что для выбранного запроса доступен адаптивный карта.

Снимок экрана: вкладка адаптивных карточек в графе Обозреватель с выделенными сведениями об ответе.

Дополнительные функции graph Обозреватель

Чтобы максимально эффективно использовать Обозреватель Graph, ознакомьтесь со следующими дополнительными функциями средства.

Журнал

Выберите Журнал , чтобы получить доступ к запросам, выполняемым за последние 30 дней, и экспортировать их.

Снимок экрана: вкладка

Параметры

Вы можете настроить пользовательский интерфейс Graph Обозреватель с помощью значка параметров в правом верхнем углу. Вы также можете развернуть, свернуть или изменить размер боковой панели.

Общий доступ

Чтобы предоставить общий доступ к текущему запросу, выберите Поделиться, чтобы пользователи могли опробовать конкретный запрос в Graph Обозреватель.

Связанные материалы