Справочник по конечной точке REST API Microsoft Graph версии 1.0

Добро пожаловать в справочник по REST API Microsoft Graph для конечной v1.0 точки.

Наборы API в конечной v1.0 точке (https://graph.microsoft.com/v1.0) достигли общедоступной доступности и прошли тщательный процесс проверки и обратной связи с клиентами для удовлетворения практических потребностей в рабочей среде. Обновления API в этой конечной точке являются аддитивными по своей природе и не нарушают существующие сценарии приложений.

Основные сценарии выполнения

Главное достоинство Microsoft Graph заключается в удобной навигации объектов и связей в разных службах, предоставляемой в единой конечной точке REST Microsoft Graph.

Некоторые из этих служб предназначены для реализации многофункциональных сценариев вокруг пользователя и группы.

Сценарии выполнения, ориентированные на пользователя, в версии 1.0

• Получите профиль и фотографию пользователя.
• Получите сведения о профиле руководителя пользователя и идентификаторы его прямых отчетов, хранящиеся в Microsoft Entra ID.
• Получите доступ к файлам пользователя в OneDrive, найдите личность последнего человека, который изменил файл в нем, и перейдите в профиль этого пользователя.
• Получите доступ к календарю пользователя Exchange Online и определите лучшее время для встречи со своей командой в ближайшие две недели.
• Подпишитесь и отслеживайте изменения в календаре пользователя, а также сообщите пользователю, когда он проводит более 80 % своего времени на собраниях.
• Настройка автоматических ответов , когда пользователь находится вне офиса.
• Получите людей, которые наиболее важны для пользователя, на основе общения, совместной работы и деловых отношений.
• Получение последней проекции продаж из диаграммы в файле Excel в OneDrive пользователя.
• Найдите задачи, назначенные пользователю в Планировщик.

Варианты использования групп Microsoft 365 в версии 1.0

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

Вызов конечной точки версии 1.0

В запросах API Microsoft Graph к конечной точке версии 1.0 используется следующий шаблон:

https://graph.microsoft.com/v1.0/{resource}?[query_parameters]

Дополнительные сведения о вызовах REST API Microsoft Graph см. в статье Использование microsoft API Graph.

Бета-версия конечной точки Microsoft Graph

В настоящее время доступны две версии REST API Microsoft Graph: версия 1.0 и бета-версия.

Если вас интересует новые и улучшенные API, которые по-прежнему находятся в предварительной версии, см. статью Справочник по конечной точке бета-версии Microsoft Graph.

Предостережение

Api в состоянии предварительной версии могут измениться и могут нарушить существующие сценарии без уведомления. Не принимайте рабочую зависимость от API в конечной точке beta .

Дополнительные сведения см. в разделе Управление версиями и поддержка.

Новые возможности

Узнайте , что нового в конечной точке версии 1.0.

Дополнительные сведения об изменениях API Microsoft Graph в версии 1.0 см. в журнале изменений API.

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

• Обзор Microsoft Graph
• Microsoft Graph Explorer
• Краткое руководство по Microsoft Graph
• Использование пакетов SDK Microsoft Graph