Справочные материалы по REST API Microsoft Graph v1.0Microsoft Graph REST API v1.0 reference

Добро пожаловать в справочник REST API Microsoft Graph для конечной точки версии 1.0.Welcome to Microsoft Graph REST API reference for the v1.0 endpoint.

Наборы API в конечной точке версии 1.0 (https://graph.microsoft.com/v1.0) находятся в общедоступном состоянии и подверглись строгому процессу проверки и отзывов при участии клиентов, чтобы удовлетворить практические и производственные требования.API sets on the v1.0 endpoint (https://graph.microsoft.com/v1.0) are in general availability (GA) status, and have gone through a rigorous review-and-feedback process with customers to meet practical, production needs. Обновления для API в этой конечной точке являются добавочными и не прерывают существующие сценарии приложения.Updates to APIs on this endpoint are additive in nature and do not break existing app scenarios.

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

Главное достоинство Microsoft Graph заключается в удобной навигации объектов и связей в разных службах, предоставляемой в единой конечной точке REST Microsoft Graph.The power of Microsoft Graph lies in easy navigation of entities and relationships across different services exposed on a single Microsoft Graph REST endpoint.

Некоторые из этих служб предназначены для выполнения сложных сценариев для пользователей и групп.A number of these services are designed to enable rich scenarios around a user and around a group.

Сценарии выполнения, ориентированные на пользователя, в версии 1.0User-centric use cases in v1.0

  1. Получение профиля и фотографии пользователя Мария.Get the profile and photo of a user, Lisa.
  2. Получение сведений о профиле менеджера Марии и идентификаторов ее подчиненных, хранимых в Azure Active Directory.Get the profile information about Lisa's manager and IDs of her direct reports, all stored in Azure Active Directory.
  3. Получение доступа к файлам Марии в OneDrive для бизнеса, поиск удостоверения последнего человека, который внес изменения в файл, и переход к профилю этого человека.Access Lisa's files on OneDrive for Business, find the identity of the last person who modified a file there, and navigate to that person's profile.
  4. Получение доступа к календарю Марии в Exchange Online и определение наиболее подходящего времени для встречи Марии с ее группой в следующие две недели.Access Lisa's calendar on Exchange Online and determine the best time for Lisa to meet with her team in the next two weeks.
  5. Подписка и отслеживание изменений в календаре Марии, уведомление Марии, если она проводит более 80% своего времени на собраниях.Subscribe to and track changes in Lisa's calendar, tell Lisa when she is spending more than 80% of her time in meetings.
  6. Настройка автоматических ответов, когда Мария находится вне офиса.Set automatic replies when Lisa is away from the office.
  7. Определение людей, которые наиболее важны для Марии, в зависимости от общения, совместной работы и корпоративных связей.Get the people who are most relevant to Lisa, based on communication, collaboration, and business relationships.
  8. Получение последней проекции продаж из диаграммы в файле Excel в инструменте Марии OneDrive для бизнеса.Get the latest sales projection from a chart in an Excel file in Lisa's OneDrive for Business.
  9. Поиск задач, назначенных Марии, в планировщике.Find the tasks assigned to Lisa in Planner.

Групповые сценарии выполнения Office 365 в версии 1.0Office 365 group use cases in v1.0

  1. Запуск отчета о группах Office 365 в организации и определение группы с самыми часто общающимися участниками группы.Run a report on Office 365 groups in an organization and identify the group with the most communication among group members.
  2. Поиск планов этой группы Office 365 и назначение задач в этом плане.Find the plans of this Office 365 group, and the assignment of tasks in that plan.
  3. Начало новой беседы в группе Office 365, чтобы определить, хотят ли участники создать другую группу для предоставление общего доступа к рабочей нагрузке.Start a new conversation in the Office 365 group to determine if members want to create another group to share the workload.
  4. Получение стандартной записной книжки для группы и создание страницы для записи результата исследования.Get the default notebook for the group and create a page to note the outcome of the investigation.

Другие версии APIOther API versions

В настоящее время существует две версии REST API Microsoft Graph – версия 1.0 и бета-версия.There are currently 2 versions of Microsoft Graph REST APIs - v1.0 and beta. Если вас интересует новые и улучшенные API, которые по-прежнему находятся в предварительной версии, см. статью Справочник по конечной точке бета-версии Microsoft Graph.If you're interested in new or enhanced APIs that are still in preview status, see Microsoft Graph beta endpoint reference. Следует помнить, что API в предварительной версии могут изменяться и могут нарушить работу существующих сценариев без уведомлений.Be aware that APIs in preview status are subject to change, and may break existing scenarios without notice. Не создавайте зависимость рабочей среды от API в конечной точке бета-версии.Don't take a production dependency on APIs in the beta endpoint.

Дополнительные сведения см. в статье Управление версиями и поддержка.Find more information about versioning and support.

Обратная связьConnect with us

Есть ли дополнительные API или функции, которые вы бы хотели увидеть в Microsoft Graph?Are there additional APIs or features you'd like to see in Microsoft Graph? Опубликуйте запросы новых функций на UserVoice.Post new feature requests on UserVoice.

Хотите оставить отзыв по существующим API Microsoft Graph?Have feedback for existing Microsoft Graph APIs? Свяжитесь с нами в Github.Connect with us on Github.