softeria/ms-365-mcp-server

softeria/ms-365-mcp-server

от softeria
MCP сервер для работы с Microsoft 365 через Graph API. Предоставляет 200+ инструментов для управления почтой, календарём и OneDrive, включая Teams и SharePoint. Автоматизируйте офисные задачи с ИИ-ассистентами.

ms-365-mcp-server

npm version build status license

Microsoft 365 MCP Server

A Model Context Protocol (MCP) server for interacting with Microsoft 365 and Microsoft Office services through the Graph API.

Supported Clouds

This server supports multiple Microsoft cloud environments:

Cloud Description Auth Endpoint Graph API Endpoint
Global (default) International Microsoft 365 login.microsoftonline.com graph.microsoft.com
China (21Vianet) Microsoft 365 operated by 21Vianet login.chinacloudapi.cn microsoftgraph.chinacloudapi.cn
GCC High Microsoft 365 US Government GCC High login.microsoftonline.us graph.microsoft.us

GCC High has no pre-registered client: register an app in your government tenant and set MS365_MCP_CLIENT_ID (and MS365_MCP_TENANT_ID), then use --cloud gcc-high.

To route Graph traffic through a proxy of your own (one that terminates the client's plain HTTP and originates TLS to Microsoft), set MS365_MCP_GRAPH_BASE_URL to its base URL; see the environment variable list under CLI Options, including what still bypasses it.

Часто задаваемые вопросы

Инструменты были проиндексированы:
accept-calendar-eventвнешний мир

Принимает указанное событие в календаре пользователя. 💡 СОВЕТ: Принимает приглашение на встречу. Необязательное тело: { sendResponse: true, comment: 'Я приду.' }. Установите sendResponse в false, чтобы принять молча без уведомления организатора.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • eventIdstringобязательный

    Значение для сегмента пути 'eventId'. Передавайте его под именем 'eventId', а не как 'id'. Используйте поле 'id' объекта события, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

add-calendar-event-attachmentвнешний мир

Добавляет вложение к существующему событию через этот API. Операция ограничивает размер вложения, которое можно добавить, до менее 3 МБ. Если организатор добавляет вложение к событию-встрече, он затем может обновить событие, чтобы отправить вложение, и обновить событие для каждого участника. 💡 СОВЕТ: Только до 3 МБ. Тело запроса требует @odata.type: {"@odata.type": "#microsoft.graph.fileAttachment", "name": "file.pdf", "contentBytes": "<base64>"}. При 3 МБ и выше используйте create-calendar-event-attachment-upload-session.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • eventIdstringобязательный

    Значение для сегмента пути 'eventId'. Передавайте его под именем 'eventId', а не как 'id'. Используйте поле 'id' объекта события, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

add-excel-table-rowsвнешний мир

Добавляет строки таблицы Excel. 💡 СОВЕТ: Добавляет строки в таблицу. Тело: { values: [['col1val', 'col2val', 'col3val'], ['row2col1', 'row2col2', 'row2col3']] }. Каждый внутренний массив соответствует одной строке. Values должны соответствовать количеству столбцов в таблице.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • workbookTableIdstringобязательный

    Значение для сегмента пути 'workbookTableId'. Передавайте его под именем 'workbookTableId', а не как 'id'. Используйте поле 'id' объекта таблицы книги, которое возвращает Microsoft Graph.

add-mail-attachmentвнешний мир

Используйте этот API для создания нового вложения. Вложение может быть одного из следующих типов: все эти типы ресурсов вложений происходят от ресурса attachment. 💡 СОВЕТ: Единственный путь для вложений размером до 3 МБ. contentBytes должен содержать полный base64 без изменений; усечённый аргумент приводит к ошибке 400 UnableToDeserializePostBody. Для вложений от 3 МБ и выше используйте create-mail-attachment-upload-session, который отклоняет файлы меньшего размера. Тело запроса требует @odata.type: {"@odata.type": "#microsoft.graph.fileAttachment", "name": "file.pdf", "contentBytes": "<base64>"}.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • messageIdstringобязательный

    Значение для сегмента пути 'messageId'. Передавайте его под именем 'messageId', а не как 'id'. Используйте поле 'id' объекта сообщения, возвращаемое Microsoft Graph.

cancel-calendar-eventвнешний мир

Это действие позволяет организатору встречи отправить сообщение об отмене и отменить событие. Действие перемещает событие в папку Deleted Items. Организатор также может отменить экземпляр повторяющейся встречи, указав идентификатор экземпляра. Участник, вызывающий это действие, получает ошибку (HTTP 400 Bad Request) со следующим сообщением: 'Your request can't be completed. You need to be an organizer to cancel a meeting.' Это действие отличается от Delete тем, что Cancel доступен только организатору и позволяет организатору отправить участникам настраиваемое сообщение об отмене. 💡 СОВЕТ: Отменяет встречу (только организатор) и отправляет сообщение об отмене всем участникам. Тело: { Comment (необязательная строка, настраиваемое сообщение) }. Используйте это вместо delete-calendar-event, если хотите, чтобы участники видели 'Canceled' в своем календаре. Участники, вызывающие это, получают HTTP 400 — им следует использовать decline-calendar-event вместо этого.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • eventIdstringобязательный

    Значение для сегмента пути 'eventId'. Передавайте его под именем 'eventId', а не как 'id'. Используйте поле 'id' объекта события, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

clear-excel-rangeвнешний мир

Очищает диапазон Excel. 💡 Совет: Очищает содержимое ячеек и/или форматирование в заданном диапазоне. Тело запроса: { applyTo: 'All' | 'Formats' | 'Contents' }. 'Contents' удаляет значения, но сохраняет форматирование; 'Formats' сбрасывает стили, но сохраняет значения; 'All' удаляет и то, и другое. Используйте эту операцию, чтобы сбросить участок листа перед новой записью, вместо того чтобы перезаписывать ячейки по одной.

Параметры
  • addressstringобязательный

    Значение для сегмента пути 'address'.

  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • workbookWorksheetIdstringобязательный

    Значение для сегмента пути 'workbookWorksheetId'. Передавайте его под именем 'workbookWorksheetId', а не как 'id'. Используйте поле 'id' объекта рабочего листа книги, возвращаемого Microsoft Graph.

copy-drive-itemвнешний мир

Копирует элемент диска. 💡 ПОДСКАЗКА: Асинхронно копирует файл или папку в новое расположение и/или под новым именем. Тело запроса: { parentReference: { driveId: '...', id: '...' }, name?: 'New Name.xlsx' }. Возвращает 202 Accepted с заголовком Location, указывающим на URL мониторинга асинхронной задачи. Идеально подходит для дублирования шаблонов (например, клонирование Armhr Census Template для каждого потенциального клиента), массового предоставления файлов или сохранения неизменяемого снимка рабочего файла.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

copy-mail-messageвнешний мир

Копирует сообщение в папку в почтовом ящике пользователя. 💡 СОВЕТ: Копирует сообщение в другую почтовую папку. Body: { DestinationId: '<mailFolder-id или стандартное имя, например inbox, archive, junkemail>' }. Возвращает вновь созданное сообщение (с новым идентификатором) в целевой папке. Для перемещения вместо копирования используйте move-mail-message.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • messageIdstringобязательный

    Значение для сегмента пути 'messageId'. Передавайте его под именем 'messageId', а не как 'id'. Используйте поле 'id' объекта сообщения, возвращаемое Microsoft Graph.

create-calendarвнешний мир

Создаёт новый календарь для пользователя. 💡 СОВЕТ: Создаёт личный календарь. Тело: { name: 'My Calendar', color: 'auto' }. Доступные цвета: auto, lightBlue, lightGreen, lightOrange, lightGray, lightYellow, lightTeal, lightPink, lightBrown, lightRed.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

create-calendar-eventвнешний мир

Создаёт (планирует) новое событие в календаре пользователя: встречу или собрание. Время задаётся вложенными объектами, а не плоскими полями: start: {dateTime, timeZone}, end: {dateTime, timeZone}. НЕ используйте startDateTime/startTimeZone. Для разовых событий проще всего использовать UTC (например, 3:30 PM AEDT = 04:30 UTC). Для повторяющихся событий используйте имя часового пояса самого организатора: Graph вычисляет DST по зоне в start.timeZone, поэтому UTC смещается после изменений DST. Получите зону из get-mailbox-settings или проверьте её с помощью list-supported-time-zones, а не угадывайте по памяти. Задаёт тему, место, содержимое и участников; поддерживает онлайн-встречи и повторяемость. 💡 СОВЕТ: КРИТИЧЕСКИ ВАЖНО: Не пытайтесь угадывать адрес электронной почты получателей. Используйте инструмент list-users, чтобы найти адрес электронной почты получателей.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

create-calendar-event-attachment-upload-sessionвнешний мир

Создаёт сеанс отправки, который позволяет приложению итеративно отправлять диапазоны файла, чтобы прикрепить файл к указанному элементу Outlook. Элемент может быть сообщением или событием. Для прикрепления файла размером от 3 МБ до 150 МБ применяется этот подход. Чтобы прикрепить файл меньше 3 МБ, выполняется операция POST для навигационного свойства attachments элемента Outlook; как это сделать для сообщения или события, описано отдельно. В ответ это действие возвращает URL отправки, который можно использовать в последующих последовательных запросах PUT. Заголовки запроса для каждой операции PUT позволяют указать точный диапазон байтов для отправки. Это позволяет возобновить передачу, если соединение с сетью прервётся во время отправки. Ниже приведены шаги, чтобы прикрепить файл к элементу Outlook с помощью сеанса отправки: Пример есть в разделе «Прикрепление больших файлов к сообщениям или событиям Outlook». 💡 СОВЕТ: Для вложений от 3 МБ до 150 МБ; для вложений меньше 3 МБ нужен add-calendar-event-attachment. Body: { AttachmentItem: { attachmentType: 'file', name: 'report.pdf', size: 5000000 } }. Возвращает предварительно аутентифицированный uploadUrl; вызывающая сторона сама отправляет туда байты методом PUT диапазонами до 4 МБ.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • eventIdstringобязательный

    Значение для сегмента пути 'eventId'. Передавайте его под именем 'eventId', а не как 'id'. Используйте поле 'id' объекта события, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

create-contact-child-folderвнешний мир

Создаёт новый contactFolder как дочерний элемент указанной папки. Также можно создать новый contactFolder в папке контактов по умолчанию пользователя. 💡 СОВЕТ: Создаёт подпапку внутри существующей папки контактов. Тело: { displayName: 'Имя подпапки' }. Используйте list-contact-folders, чтобы узнать идентификатор родительской папки. Возвращаемый contactFolder имеет собственный идентификатор, который можно использовать с update-contact-folder, delete-contact-folder, list-contact-folder-contacts и create-contact-in-folder, идентификаторы contactFolder уникальны в пределах почтового ящика независимо от глубины вложенности.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • contactFolderIdstringобязательный

    Значение для сегмента пути 'contactFolderId'. Передавайте его под именем 'contactFolderId', а не как 'id'. Используйте поле 'id' объекта папки контактов, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

create-contact-folderвнешний мир

Создаёт новый contactFolder в папке контактов пользователя по умолчанию. Вы также можете создать новый contactfolder как дочерний элемент любой указанной папки контактов. 💡 СОВЕТ: Создаёт новую папку контактов в корне почтового ящика пользователя. Body: { displayName: 'Family' }. Возвращает созданный contactFolder с его id. Чтобы создать подпапку в существующей папке, используйте create-contact-child-folder.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

create-contact-in-folderвнешний мир

Добавляет контакт в корневую папку Contacts или в конечную точку contacts другой папки контактов. 💡 TIP: Создаёт контакт внутри конкретной папки (вместо папки Contacts по умолчанию). Тело — ресурс контакта: { givenName, surname, displayName, emailAddresses: [{ address, name }], businessPhones: [], mobilePhone, jobTitle, companyName, ... }. Существующий create-outlook-contact (POST /me/contacts) записывает только в папку по умолчанию; используйте этот инструмент при организации контактов в именованные папки. Получите идентификатор папки через list-contact-folders.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • contactFolderIdstringобязательный

    Значение для сегмента пути 'contactFolderId'. Передавайте его под именем 'contactFolderId', а не как 'id'. Используйте поле 'id' объекта папки контактов, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

create-draft-emailвнешний мир

Создаёт черновик сообщения Outlook в папке Drafts вошедшего пользователя. Устанавливает тему, тело, toRecipients, ccRecipients и важность. Черновик сохраняется, а не отправляется. Используйте send-mail, чтобы отправить сообщение напрямую, или отправьте черновик позже.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

create-drive-item-previewвнешний мир

Создаёт предварительный просмотр элемента диска. 💡 СОВЕТ: Генерирует кратковременную встраиваемую ссылку для предварительного просмотра файла (документы Office, PDF, изображения). Тело: { page?: number | string, zoom?: number, viewer?: 'onedrive' | 'office' }. Возвращает getUrl (интерактивный) и postUrl (отправка формы). Полезен для отображения встроенных превью в сводных письмах или сообщениях чата без необходимости получателю открывать файл.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

create-drive-item-share-linkвнешний мир

Создаёт ссылку для предоставления общего доступа к DriveItem. Действие createLink создаёт новую ссылку для общего доступа, если указанный тип ссылки ещё не существует для вызывающего приложения. Если ссылка для общего доступа указанного типа уже существует для приложения, возвращается существующая ссылка. Ресурсы DriveItem наследуют разрешения на общий доступ от своих предков. 💡 СОВЕТ: Создайте ссылку для общего доступа к файлу или папке БЕЗ отправки приглашения по электронной почте. Тело: { type: 'view' | 'edit' | 'embed', scope: 'anonymous' | 'organization' | 'users', password?: string, expirationDateTime?: ISO-8601, retainInheritedPermissions?: boolean }. Возвращает разрешение с link.webUrl. Используйте вместе с share-drive-item, когда нужно предоставить явный доступ; используйте этот инструмент, когда нужен только URL для вставки в документ/письмо/чат без отправки уведомлений OneDrive.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

create-excel-chartвнешний мир

Создаёт новую диаграмму.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • workbookWorksheetIdstringобязательный

    Значение для сегмента пути 'workbookWorksheetId'. Передавайте его под именем 'workbookWorksheetId', а не как 'id'. Используйте поле 'id' объекта рабочего листа книги, возвращаемого Microsoft Graph.

create-excel-tableвнешний мир

Создаёт новую таблицу. Адрес исходного диапазона определяет лист, на который будет добавлена таблица. Если таблицу не удаётся добавить (например, из-за неверного адреса или если таблица будет пересекаться с другой таблицей), генерируется ошибка. 💡 СОВЕТ: Преобразует диапазон листа в формальную таблицу Excel. Body: { address: 'A1:H171', hasHeaders: true }. Требуется перед использованием add-excel-table-rows / update-excel-table-row / delete-excel-table-row на листе с обычными ячейками.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • workbookWorksheetIdstringобязательный

    Значение для сегмента пути 'workbookWorksheetId'. Передавайте его под именем 'workbookWorksheetId', а не как 'id'. Используйте поле 'id' объекта рабочего листа книги, возвращаемого Microsoft Graph.

create-focused-inbox-overrideвнешний мир

Создает переопределение для отправителя, указанного по SMTP-адресу. Будущие сообщения с этого SMTP-адреса будут последовательно классифицироваться в соответствии с переопределением. Примечание 💡 СОВЕТ: Создает переопределение Focused Inbox для отправителя. Body: { classifyAs: 'focused', senderEmailAddress: { name: 'Display Name', address: 'sender@example.com' } }. classifyAs должно быть 'focused' или 'other'. Если для этого SMTP-адреса уже существует переопределение, POST обновляет имя и classifyAs существующего переопределения (используйте это, чтобы переименовать отправителя). Узнайте адрес отправителя с помощью list-users или прочитав последний заголовок письма — не выдумывайте SMTP-адреса.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

create-forward-draftвнешний мир

Создаёт черновик пересылаемого письма. 💡 СОВЕТ: Создаёт черновик пересылки (не отправляет). Полезно, когда пользователь хочет просмотреть перед отправкой.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • messageIdstringобязательный

    Значение для сегмента пути 'messageId'. Передавайте его под именем 'messageId', а не как 'id'. Используйте поле 'id' объекта сообщения, возвращаемое Microsoft Graph.

create-mail-attachment-upload-sessionвнешний мир

Создаёт сеанс загрузки, который позволяет приложению итеративно загружать диапазоны файла, чтобы прикрепить его к указанному элементу Outlook. Элементом может быть сообщение или событие. Используйте этот подход для прикрепления файла, если его размер от 3 МБ до 150 МБ. Для прикрепления файла размером меньше 3 МБ выполните операцию POST для навигационного свойства attachments элемента Outlook; см. как это сделать для сообщения или для события. В ответе это действие возвращает URL для загрузки, который можно использовать в последующих последовательных PUT-запросах. Заголовки запросов каждой операции PUT позволяют указать точный диапазон байтов для загрузки. Это позволяет возобновить передачу, если сетевое соединение прервалось во время загрузки. Ниже приведены шаги для прикрепления файла к элементу Outlook с помощью сеанса загрузки: пример см. в разделе «Прикрепление больших файлов к сообщениям или событиям Outlook». 💡 ПОДСКАЗКА: для вложений от 3 МБ до 150 МБ. Graph отклоняет файлы меньшего размера с ошибкой ErrorAttachmentSizeShouldNotBeLessThanMinimumSize, поэтому для файлов до 3 МБ используйте add-mail-attachment. Тело: { AttachmentItem: { attachmentType: 'file', name: 'report.pdf', size: 5000000 } }. Возвращает предварительно аутентифицированный uploadUrl; вызывающая сторона сама отправляет туда байты диапазонами до 4 МБ. Этот сервер не выполняет PUT.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • messageIdstringобязательный

    Значение для сегмента пути 'messageId'. Передавайте его под именем 'messageId', а не как 'id'. Используйте поле 'id' объекта сообщения, возвращаемое Microsoft Graph.

create-mail-child-folderвнешний мир

Используйте этот API, чтобы создать новую дочернюю почтовую папку (mailFolder). Если вы намереваетесь скрыть новую папку, необходимо установить свойство isHidden в значение true при создании. 💡 ПОДСКАЗКА: Создает подпапку внутри существующей почтовой папки. Используйте list-mail-folders или list-mail-child-folders, чтобы найти ID родительской папки.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • mailFolderIdstringобязательный

    Значение для сегмента пути 'mailFolderId'. Передавайте его под именем 'mailFolderId', а не как 'id'. Используйте поле 'id' объекта почтовой папки, возвращаемое Microsoft Graph.

create-mail-folderвнешний мир

Используйте этот API для создания новой почтовой папки в корневой папке почтового ящика пользователя. Если вы хотите, чтобы новая папка была скрытой, необходимо установить свойство isHidden в true при создании. 💡 СОВЕТ: Создаёт почтовую папку верхнего уровня. Используйте create-mail-child-folder для создания вложенной папки внутри существующей папки. Используйте list-mail-folders для поиска идентификаторов существующих папок.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

create-mail-ruleвнешний мир

Создаёт объект messageRule с указанным набором условий и действий. Outlook выполняет эти действия, если входящее сообщение в папке «Входящие» пользователя соответствует заданным условиям. 💡 СОВЕТ: Создаёт правило сообщения для почтовой папки. Используйте ID папки «Входящие» (получите его из list-mail-folders) для правил на входящие. Тело запроса: { displayName: 'Имя правила', sequence: 1, isEnabled: true, conditions: { fromAddresses: [{ emailAddress: { address: 'user@example.com' } }] }, actions: { moveToFolder: 'folder-id' } }. Действия: moveToFolder, copyToFolder, forwardTo, forwardAsAttachmentTo, delete, markAsRead, markImportance, stopProcessingRules.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • mailFolderIdstringобязательный

    Значение для сегмента пути 'mailFolderId'. Передавайте его под именем 'mailFolderId', а не как 'id'. Используйте поле 'id' объекта почтовой папки, возвращаемое Microsoft Graph.

create-my-calendar-permissionвнешний мир

Создаёт ресурс calendarPermission, указывающий личность и роль пользователя, с которым указанный календарь предоставляется в общий доступ или делегируется. 💡 СОВЕТ: Предоставляет общий доступ к основному календарю пользователя другому пользователю (или настраивает делегата). Тело: { emailAddress: { name: 'Adele Vance', address: 'adele@contoso.com' }, role: 'read' | 'write' | 'delegateWithoutPrivateEventAccess' | 'delegateWithPrivateEventAccess', isInsideOrganization: true, isRemovable: true }. Используйте list-users для определения SMTP-адреса получателя. Возвращает созданный calendarPermission с его id (используется методами update-my-calendar-permission и delete-my-calendar-permission).

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

create-onedrive-folderвнешний мир

Создаёт папку OneDrive. 💡 СОВЕТ: Создаёт новую папку внутри указанного элемента диска. Тело запроса должно включать поля name (string) и folder ({}). Используйте @microsoft.graph.conflictBehavior для управления поведением при конфликте имён: 'rename' (по умолчанию), 'replace' или 'fail'.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

create-onenote-notebookвнешний мир

Создаёт новую записную книжку OneNote. 💡 ПОДСКАЗКА: Создаёт новую записную книжку OneNote. Тело: { displayName: 'Notebook Name' }. Имя должно быть уникальным среди всех записных книжек пользователя.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

create-onenote-pageвнешний мир

Создаёт новую страницу OneNote в разделе по умолчанию стандартной записной книжки. Чтобы создать страницу в другом разделе той же записной книжки, используйте параметр запроса sectionName. Пример: ../onenote/pages?sectionName=My%20section. Операция POST /onenote/pages используется только для создания страниц в записной книжке по умолчанию текущего пользователя. Если вы работаете с другими записными книжками, вы можете создавать страницы в указанном разделе. 💡 СОВЕТ: Тело запроса должно быть полным HTML-документом (с <html><head><title>...</title></head><body>...</body></html>). Частичный HTML или обычный текст незаметно завершается ошибкой или создаёт некорректные страницы.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

create-onenote-sectionвнешний мир

Создаёт новый onenoteSection в указанной записной книжке. 💡 TIP: Создаёт новый раздел в записной книжке. Body: { displayName: 'Section Name' }

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • notebookIdstringобязательный

    Значение для сегмента пути 'notebookId'. Передавайте его под именем 'notebookId', а не как 'id'. Используйте поле 'id' объекта notebook, которое возвращает Microsoft Graph.

create-onenote-section-pageвнешний мир

Создаёт новую страницу в указанном разделе. 💡 СОВЕТ: Тело должно быть полным HTML-документом (с <html><head><title>...</title></head><body>...</body></html>). Частичный HTML молча завершается ошибкой.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • onenoteSectionIdstringобязательный

    Значение для сегмента пути 'onenoteSectionId'. Передавайте его под именем 'onenoteSectionId', а не как 'id'. Используйте поле 'id' объекта раздела OneNote, которое возвращает Microsoft Graph.

create-outlook-categoryвнешний мир

Создаёт объект outlookCategory в главном списке категорий пользователя. 💡 ПОДСКАЗКА: Создаёт новую категорию Outlook. Тело: { displayName (уникальный), color (один из: none, preset0 … preset24 - соответствует red, orange, yellow, green, teal, olive, blue, purple, cranberry, steel, dark-steel, gray, dark-gray, black, dark-red, dark-orange, dark-yellow, dark-green, dark-teal, dark-olive, dark-blue, dark-purple, dark-cranberry) }. Имена категорий чувствительны к регистру при применении к сообщениям/событиям.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

create-outlook-contactвнешний мир

Добавляет контакт в корневую папку контактов или в конечную точку контактов другой папки контактов.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

create-planner-bucketвнешний мир

Создаёт новый объект plannerBucket.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

create-planner-taskвнешний мир

Создаёт новый plannerTask.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

create-planner-task-messageвнешний мир

[beta] Создаёт новое plannerTaskChatMessage в plannerTask. 💡 СОВЕТ: Отправляет сообщение в чат задачи Planner (современный «чат задачи», а не устаревший conversationThreadId). Microsoft убирает классические комментарии к задачам и скрывает их из задачи (обновление Planner 2026), поэтому чат задачи — это текущий поддерживаемый способ публикации обновлений по задаче, которые увидят коллеги, с @упоминаниями. Тело: { content: 'обычный текст или очищенный HTML', mentions?: [{ mentioned: 'идентификатор-пользователя', position: 0, mentionType: 'user' }] } (mentions опционально). ETag/If-Match не требуется. BETA Graph API: может измениться; только делегированные рабочие/учебные учетные записи — без разрешений приложения, без личных учетных записей Microsoft, только глобальное облако (не GCC/DoD/21Vianet).

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • plannerTaskIdstringобязательный

    Значение для сегмента пути 'plannerTaskId'. Передавайте его под именем 'plannerTaskId', а не 'id'. Используйте поле 'id' объекта planner task, возвращаемое Microsoft Graph.

create-reply-all-draftвнешний мир

Создаёт черновик ответа отправителю и всем получателям сообщения в формате JSON или MIME. При использовании формата JSON: - Указывает либо comment, либо свойство body параметра message. Указание обоих возвращает ошибку HTTP 400 Bad Request. - Если исходное сообщение задаёт получателя в свойстве replyTo, по стандарту Internet Message Format (RFC 2822) отправляйте ответ получателям из свойств replyTo и toRecipients, а не получателям из свойств from и toRecipients. - Черновик можно обновить позже — добавить содержимое ответа в тело или изменить другие свойства сообщения. При использовании формата MIME: - Указывает соответствующие заголовки интернет-сообщений и MIME-содержимое: всё кодируется в base64 в теле запроса. - Добавляет любые вложения и свойства S/MIME в MIME-содержимое. Отправляет черновик сообщения последующей операцией. Либо отвечает всем в одном действии. 💡 ПОДСКАЗКА: Для HTML-ответов передавайте Message.body.contentType: 'html' с Message.body.content в виде HTML. Примечание: передача Message.body заменяет всё тело черновика, поэтому исходная цитируемая история не включается. Указание одновременно 'comment' и Message.body возвращает 400. Подписи добавляются только клиентом Outlook, не через Graph.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • messageIdstringобязательный

    Значение для сегмента пути 'messageId'. Передавайте его под именем 'messageId', а не как 'id'. Используйте поле 'id' объекта сообщения, возвращаемое Microsoft Graph.

create-reply-draftвнешний мир

Создаёт черновик для ответа отправителю сообщения в формате JSON или MIME. При использовании JSON: - Указывает либо комментарий, либо свойство body параметра message. Указание обоих возвращает ошибку HTTP 400 Bad Request. - Если в исходном сообщении указан replyTo, согласно Internet Message Format (RFC 2822), следует отправлять ответ получателям из replyTo, а не из from. - Черновик можно обновить позже, чтобы добавить текст ответа в body или изменить другие свойства сообщения. При использовании MIME: - Предоставляет применимые заголовки Internet-сообщений и MIME-содержимое, все закодированные в формате base64 в теле запроса. - Добавляет любые вложения и свойства S/MIME в MIME-содержимое. Отправляет черновик сообщения последующей операцией. Или отвечает на сообщение одной операцией. 💡 СОВЕТ: Для HTML-ответов передаёт Message.body.contentType: 'html' с Message.body.content в виде HTML. Примечание: передача Message.body заменяет всё тело черновика, поэтому исходная цитируемая история не включается. Указание и 'comment', и Message.body возвращает 400. Подписи добавляются только клиентом Outlook.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • messageIdstringобязательный

    Значение для сегмента пути 'messageId'. Передавайте его под именем 'messageId', а не как 'id'. Используйте поле 'id' объекта сообщения, возвращаемое Microsoft Graph.

create-specific-calendar-eventвнешний мир

Создаёт событие в конкретном календаре. Требует calendarId (идентификатор целевого календаря). Время задаётся вложенными объектами {dateTime, timeZone}: НЕ используйте startDateTime/startTimeZone. UTC проще всего для разовых событий; для повторяющихся событий используйте часовой пояс организатора (из get-mailbox-settings или list-supported-time-zones) вместо UTC, поскольку Graph вычисляет переход на летнее время относительно этого пояса. 💡 СОВЕТ: КРИТИЧЕСКИ ВАЖНО: Не пытайтесь угадать адрес электронной почты получателей. Используйте инструмент list-users, чтобы найти адрес электронной почты получателей.

Параметры
  • bodyobjectобязательный
  • calendarIdstringобязательный

    Значение для сегмента пути 'calendarId'. Передавайте его под именем 'calendarId', а не как 'id'. Используйте поле 'id' объекта календаря, возвращаемого Microsoft Graph.

  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

create-subscriptionвнешний мир

Подписывает приложение-слушатель на получение уведомлений об изменениях определённых типов в указанном ресурсе Microsoft Graph. Чтобы определить ресурсы, для которых можно создавать подписки, и ограничения подписок, см. раздел Настройка уведомлений об изменениях данных ресурсов: Поддерживаемые ресурсы. Некоторые ресурсы поддерживают расширенные уведомления — уведомления, содержащие данные ресурса. Дополнительные сведения о таких ресурсах см. в разделе Настройка уведомлений об изменениях, включающих данные ресурса: Поддерживаемые ресурсы. 💡 СОВЕТ: Создаёт вебхук-подписку для уведомлений об изменениях. Обязательное тело запроса: { changeType (через запятую: 'created,updated,deleted'), notificationUrl (HTTPS, должен пройти проверку с помощью токена эха), resource (например '/me/mailFolders/inbox/messages', '/users/{id}/events', '/teams/{id}/channels/{id}/messages'), expirationDateTime (ISO 8601, максимальное значение зависит от типа ресурса — 1 час для звонков, 24 часа для сообщений, 3 дня для почты), clientState (непрозрачная строка, возвращается в уведомлениях, для проверки) }. Необязательно: includeResourceData (true включает расширенные уведомления, требуется encryptionCertificate + encryptionCertificateId). Отдельная область не требуется — вызывающий должен иметь разрешение на чтение целевого ресурса (например Mail.Read, Calendars.Read, ChannelMessage.Read.All, Files.Read.All).

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

create-todo-checklist-itemвнешний мир

Создаёт новый объект checklistItem. 💡 СОВЕТ: Добавляет шаг (элемент чек-листа) в существующую задачу To Do. Тело: { displayName: "..." }; необязательный isChecked (по умолчанию false). Возвращает новый элемент с его id. Чтобы добавить шаги при создании задачи, вместо этого передайте checklistItems в теле create-todo-task.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • todoTaskIdstringобязательный

    Значение для сегмента пути 'todoTaskId'. Передавайте его под именем 'todoTaskId', а не как 'id'. Используйте поле 'id' объекта задачи todo, возвращаемое Microsoft Graph.

  • todoTaskListIdstringобязательный

    Значение для сегмента пути 'todoTaskListId'. Передавайте его под именем 'todoTaskListId', а не как 'id'. Используйте поле 'id' объекта списка задач todo, возвращаемое Microsoft Graph.

create-todo-linked-resourceвнешний мир

Создаёт объект linkedResource для связывания указанной задачи с элементом в партнерском приложении. Например, вы можете связать задачу с элементом электронной почты в Outlook, который побудил задачу, и создать объект linkedResource для отслеживания этой связи. Вы также можете создать объект linkedResource при создании самой задачи. 💡 СОВЕТ: Связывает ресурс с задачей To Do. Тело: { webUrl: 'https://...', applicationName: 'Mail', displayName: 'Related email', externalId: 'optional-id' }. Связывает задачи с электронными письмами, файлами или веб-страницами для контекста.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • todoTaskIdstringобязательный

    Значение для сегмента пути 'todoTaskId'. Передавайте его под именем 'todoTaskId', а не как 'id'. Используйте поле 'id' объекта задачи todo, возвращаемое Microsoft Graph.

  • todoTaskListIdstringобязательный

    Значение для сегмента пути 'todoTaskListId'. Передавайте его под именем 'todoTaskListId', а не как 'id'. Используйте поле 'id' объекта списка задач todo, возвращаемое Microsoft Graph.

create-todo-taskвнешний мир

Создаёт новый объект задачи в указанном todoTaskList. 💡 TIP: Создаёт новую задачу в списке Microsoft To Do. Body: { title: "..." }; необязательные dueDateTime, reminderDateTime, importance, body (notes), recurrence, categories и checklistItems: [{ displayName: "...", isChecked: false }], чтобы сразу создать шаги задачи (isChecked необязателен). Требует todoTaskListId из list-todo-task-lists. Чтобы изменить шаги после создания задачи, используйте инструменты *-todo-checklist-item.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • todoTaskListIdstringобязательный

    Значение для сегмента пути 'todoTaskListId'. Передавайте его под именем 'todoTaskListId', а не как 'id'. Используйте поле 'id' объекта списка задач todo, возвращаемое Microsoft Graph.

create-todo-task-listвнешний мир

Создаёт новый объект списка. 💡 СОВЕТ: Создаёт новый список задач Microsoft To Do (именованные списки задач, отображаемые на боковой панели приложения To Do). Тело запроса: { displayName: 'My new list' }. Возвращает созданный todoTaskList с его id, displayName, isOwner, isShared и wellknownListName ('none' для списков, созданных пользователем). Встроенные списки ('Tasks', 'Flagged emails') уже существуют, и их нельзя создать заново. Используйте вместе с create-todo-task для создания задач.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

create-upload-sessionвнешний мир

Создаёт сеанс загрузки. 💡 СОВЕТ: Для загрузки больших файлов (без ограничений по размеру и без минимального, в отличие от сеанса вложений Outlook). Возвращает предварительно аутентифицированный uploadUrl; вызывающий сам PUT-запросом отправляет туда байты. Этот сервер не выполняет PUT. Для новых файлов используйте путь: /items/{parentId}:/{fileName}:/createUploadSession. Тело запроса (необязательно): { item: { '@microsoft.graph.conflictBehavior': 'rename' } }.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

decline-calendar-eventвнешний мир

Отклоняет приглашение на указанное событие в календаре пользователя. Если событие допускает предложения нового времени, при отклонении события приглашенный может предложить альтернативное время, включив параметр proposedNewTime. Дополнительную информацию о том, как предложить время и как получить и принять предложение нового времени, см. в разделе Propose new meeting times. 💡 TIP: Отклоняет приглашение на встречу. Необязательное тело: { sendResponse: true, comment: 'Cannot attend, conflict.' }. Событие остается в календаре как отклоненное, если пользователь не удалит его.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • eventIdstringобязательный

    Значение для сегмента пути 'eventId'. Передавайте его под именем 'eventId', а не как 'id'. Используйте поле 'id' объекта события, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

delete-calendarвнешний мир

Удаляет календарь, кроме календаря по умолчанию. 💡 СОВЕТ: Удаляет календарь и все его события. Календарь по умолчанию нельзя удалить. Это действие нельзя отменить.

Параметры
  • calendarIdstringобязательный

    Значение для сегмента пути 'calendarId'. Передавайте его под именем 'calendarId', а не как 'id'. Используйте поле 'id' объекта календаря, возвращаемого Microsoft Graph.

  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

delete-calendar-eventвнешний мир

Удаляет указанное событие из содержащего календаря. Если событие является встречей, удаление события в календаре организатора отправляет сообщение об отмене участникам встречи. 💡 СОВЕТ: Удаление seriesMaster удаляет ВСЕ вхождения повторяющегося события. Чтобы отменить одно вхождение, удалите конкретный идентификатор экземпляра из list-calendar-event-instances.

Параметры
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • eventIdstringобязательный

    Значение для сегмента пути 'eventId'. Передавайте его под именем 'eventId', а не как 'id'. Используйте поле 'id' объекта события, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

delete-contact-folderвнешний мир

Удаляет контактную папку, отличную от папки по умолчанию. 💡 СОВЕТ: Удаляет контактную папку. Папку по умолчанию 'Contacts' удалить нельзя - Graph возвращает ошибку. Папка (и её содержимое) обычно попадает в Deleted Items, а не удаляется навсегда. Получите идентификатор папки через list-contact-folders.

Параметры
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • contactFolderIdstringобязательный

    Значение для сегмента пути 'contactFolderId'. Передавайте его под именем 'contactFolderId', а не как 'id'. Используйте поле 'id' объекта папки контактов, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

delete-drive-item-permissionвнешний мир

Удаляет разрешение элемента диска. 💡 СОВЕТ: Удаляет конкретное разрешение из файла или папки. Удалить можно только неунаследованные разрешения. Сначала используйте list-drive-item-permissions, чтобы найти идентификатор разрешения.

Параметры
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • permissionIdstringобязательный

    Значение для сегмента пути 'permissionId'. Передайте его под именем 'permissionId', а не как 'id'. Используйте поле 'id' объекта permission, возвращаемое Microsoft Graph.

delete-excel-rangeвнешний мир

Удаляет диапазон Excel. 💡 СОВЕТ: Удаляет ячейки в указанном диапазоне, сдвигая оставшееся содержимое. Body: { shift: 'Up' } или { shift: 'Left' }. Используйте 'Up', чтобы удалить ячейки и сдвинуть вверх, 'Left' - сдвинуть влево.

Параметры
  • addressstringобязательный

    Значение для сегмента пути 'address'.

  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • workbookWorksheetIdstringобязательный

    Значение для сегмента пути 'workbookWorksheetId'. Передавайте его под именем 'workbookWorksheetId', а не как 'id'. Используйте поле 'id' объекта рабочего листа книги, возвращаемого Microsoft Graph.

delete-excel-table-rowвнешний мир

Удаляет строку таблицы Excel. 💡 СОВЕТ: Удалите одну строку из формальной таблицы Excel по индексу, начинающемуся с нуля.

Параметры
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • indexstringобязательный

    Значение для сегмента пути 'index'.

  • workbookTableIdstringобязательный

    Значение для сегмента пути 'workbookTableId'. Передавайте его под именем 'workbookTableId', а не как 'id'. Используйте поле 'id' объекта таблицы книги, которое возвращает Microsoft Graph.

delete-focused-inbox-overrideвнешний мир

Удаляет переопределение, указанное по его ID. 💡 СОВЕТ: Удаляет переопределение Focused Inbox. Будущие сообщения от этого отправителя возвращаются к поведению по умолчанию классификатора Outlook ML. Используйте list-focused-inbox-overrides, чтобы сначала найти ID.

Параметры
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • inferenceClassificationOverrideIdstringобязательный

    Значение для сегмента пути 'inferenceClassificationOverrideId'. Передавайте его под именем 'inferenceClassificationOverrideId', а не как 'id'. Используйте поле 'id' объекта переопределения классификации входящих сообщений, которое возвращает Microsoft Graph.

delete-mail-attachmentвнешний мир

Удаляет вложение электронной почты.

Параметры
  • attachmentIdstringобязательный

    Значение для сегмента пути 'attachmentId'. Передавайте его под именем 'attachmentId', а не как 'id'. Используйте поле 'id' объекта вложения, возвращаемое Microsoft Graph.

  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • messageIdstringобязательный

    Значение для сегмента пути 'messageId'. Передавайте его под именем 'messageId', а не как 'id'. Используйте поле 'id' объекта сообщения, возвращаемое Microsoft Graph.

delete-mail-folderвнешний мир

Удаляет указанную папку mailFolder. Папка может быть mailSearchFolder. Можно указать папку почты по её идентификатору папки или по её общеизвестному имени папки, если оно существует. 💡 СОВЕТ: Удаляет папку почты и всё её содержимое. Это действие необратимо. Используйте list-mail-folders, чтобы найти идентификатор папки.

Параметры
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • mailFolderIdstringобязательный

    Значение для сегмента пути 'mailFolderId'. Передавайте его под именем 'mailFolderId', а не как 'id'. Используйте поле 'id' объекта почтовой папки, возвращаемое Microsoft Graph.

delete-mail-messageвнешний мир

Удаляет сообщение электронной почты Outlook по его идентификатору сообщения. Это мягкое удаление, которое перемещает сообщение в Deleted Items. 💡 СОВЕТ: Мягкое удаление — перемещает в Deleted Items. Чтобы удалить навсегда, удалите снова из Deleted Items.

Параметры
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • messageIdstringобязательный

    Значение для сегмента пути 'messageId'. Передавайте его под именем 'messageId', а не как 'id'. Используйте поле 'id' объекта сообщения, возвращаемое Microsoft Graph.

delete-mail-ruleвнешний мир

Удаляет указанный объект messageRule. 💡 СОВЕТ: Удаляет правило сообщения без возможности восстановления. Используйте идентификатор папки Inbox (получите его из list-mail-folders) для правил входящих сообщений.

Параметры
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • mailFolderIdstringобязательный

    Значение для сегмента пути 'mailFolderId'. Передавайте его под именем 'mailFolderId', а не как 'id'. Используйте поле 'id' объекта почтовой папки, возвращаемое Microsoft Graph.

  • messageRuleIdstringобязательный

    Значение для сегмента пути 'messageRuleId'. Передавайте его под именем 'messageRuleId', а не как 'id'. Используйте поле 'id' объекта правила сообщения, возвращаемое Microsoft Graph.

delete-my-calendar-permissionвнешний мир

Удаляет разрешение для моего календаря. 💡 СОВЕТ: Отменяет общий доступ к календарю или делегированный доступ. Получите идентификатор разрешения через list-my-calendar-permissions. Разрешения, у которых isRemovable=false (например, неявное разрешение 'My Organization' по умолчанию), нельзя удалить — Graph возвращает ошибку.

Параметры
  • calendarPermissionIdstringобязательный

    Значение для сегмента пути 'calendarPermissionId'. Передавайте его под именем 'calendarPermissionId', а не как 'id'. Используйте поле 'id' объекта разрешения календаря, возвращаемого Microsoft Graph.

  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

delete-onedrive-fileвнешний мир

Удаляет файл OneDrive.

Параметры
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

delete-onenote-pageвнешний мир

Удаляет страницу OneNote. 💡 СОВЕТ: Удаляет страницу OneNote навсегда. Это действие нельзя отменить.

Параметры
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • onenotePageIdstringобязательный

    Значение для сегмента пути 'onenotePageId'. Передавайте его под именем 'onenotePageId', а не как 'id'. Используйте поле 'id' объекта страницы OneNote, возвращаемое Microsoft Graph.

delete-outlook-contactвнешний мир

Удаляет контакт.

Параметры
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • contactIdstringобязательный

    Значение для сегмента пути 'contactId'. Передавайте его под именем 'contactId', а не как 'id'. Используйте поле 'id' объекта контакта, возвращаемого Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

delete-planner-bucketвнешний мир

Удаляет plannerBucket. 💡 ПОДСКАЗКА: КРИТИЧЕСКИ ВАЖНО: Требуется заголовок If-Match с ETag из get-planner-bucket (используйте includeHeaders=true).

Параметры
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • plannerBucketIdstringобязательный

    Значение для сегмента пути 'plannerBucketId'. Передавайте его под именем 'plannerBucketId', а не как 'id'. Используйте поле 'id' объекта bucket планировщика, возвращаемого Microsoft Graph.

delete-planner-task-messageвнешний мир

[beta] Удаляет объект plannerTaskChatMessage. 💡 СОВЕТ: Удаляет сообщение из чата задачи Planner. Тело запроса не требуется; If-Match опционален для условного удаления; возвращает 204. BETA Graph API: может измениться; только делегированные рабочие/учебные учетные записи, без разрешений приложения, без личных учетных записей Microsoft, только глобальное облако (не GCC/DoD/21Vianet). 💡 СОВЕТ: Используйте это только если у вас есть идентификатор чата и идентификатор задачи. Предпочтительнее использовать метод list для поиска идентификатора сообщения.

Параметры
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • plannerTaskChatMessageIdstringобязательный

    Значение для сегмента пути 'plannerTaskChatMessageId'. Передавайте его под именем 'plannerTaskChatMessageId', а не как 'id'. Используйте поле 'id' объекта сообщения чата задачи планировщика, возвращаемого Microsoft Graph.

  • plannerTaskIdstringобязательный

    Значение для сегмента пути 'plannerTaskId'. Передавайте его под именем 'plannerTaskId', а не 'id'. Используйте поле 'id' объекта planner task, возвращаемое Microsoft Graph.

delete-specific-calendar-eventвнешний мир

Удаляет конкретное событие календаря. Требует calendarId (идентификатор целевого календаря) и eventId (собственный идентификатор события). 💡 СОВЕТ: Удаление seriesMaster удаляет ВСЕ вхождения. Чтобы отменить одно вхождение, используйте конкретный ID экземпляра.

Параметры
  • calendarIdstringобязательный

    Значение для сегмента пути 'calendarId'. Передавайте его под именем 'calendarId', а не как 'id'. Используйте поле 'id' объекта календаря, возвращаемого Microsoft Graph.

  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • eventIdstringобязательный

    Значение для сегмента пути 'eventId'. Передавайте его под именем 'eventId', а не как 'id'. Используйте поле 'id' объекта события, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

delete-subscriptionвнешний мир

Удаляет подписку. Список ресурсов, поддерживающих подписку на уведомления об изменениях, см. в таблице в разделе Permissions. 💡 СОВЕТ: Удаляет подписку вебхука. Последующие уведомления об изменениях отправляться не будут. Используйте, чтобы очистить устаревшие подписки или прекратить получение уведомлений. Используйте list-subscriptions, чтобы найти идентификатор.

Параметры
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • subscriptionIdstringобязательный

    Значение для сегмента пути 'subscriptionId'. Передавайте его под именем 'subscriptionId', а не как 'id'. Используйте поле 'id' объекта подписки, возвращаемое Microsoft Graph.

delete-todo-checklist-itemвнешний мир

Удаляет объект checklistItem. 💡 СОВЕТ: Удаляет шаг (элемент чек-листа) из задачи To Do. Это нельзя отменить. Требуется checklistItemId из list-todo-checklist-items.

Параметры
  • checklistItemIdstringобязательный

    Значение для сегмента пути 'checklistItemId'. Передайте его под именем 'checklistItemId', а не как 'id'. Используйте поле 'id' объекта элемента контрольного списка, возвращаемого Microsoft Graph.

  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • todoTaskIdstringобязательный

    Значение для сегмента пути 'todoTaskId'. Передавайте его под именем 'todoTaskId', а не как 'id'. Используйте поле 'id' объекта задачи todo, возвращаемое Microsoft Graph.

  • todoTaskListIdstringобязательный

    Значение для сегмента пути 'todoTaskListId'. Передавайте его под именем 'todoTaskListId', а не как 'id'. Используйте поле 'id' объекта списка задач todo, возвращаемое Microsoft Graph.

delete-todo-linked-resourceвнешний мир

Удаляет объект linkedResource. 💡 TIP: Удаляет связанный ресурс из задачи To Do.

Параметры
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • linkedResourceIdstringобязательный

    Значение для сегмента пути 'linkedResourceId'. Передавайте его под именем 'linkedResourceId', а не как 'id'. Используйте поле 'id' объекта связанного ресурса, которое возвращает Microsoft Graph.

  • todoTaskIdstringобязательный

    Значение для сегмента пути 'todoTaskId'. Передавайте его под именем 'todoTaskId', а не как 'id'. Используйте поле 'id' объекта задачи todo, возвращаемое Microsoft Graph.

  • todoTaskListIdstringобязательный

    Значение для сегмента пути 'todoTaskListId'. Передавайте его под именем 'todoTaskListId', а не как 'id'. Используйте поле 'id' объекта списка задач todo, возвращаемое Microsoft Graph.

delete-todo-taskвнешний мир

Удаляет объект todoTask.

Параметры
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • todoTaskIdstringобязательный

    Значение для сегмента пути 'todoTaskId'. Передавайте его под именем 'todoTaskId', а не как 'id'. Используйте поле 'id' объекта задачи todo, возвращаемое Microsoft Graph.

  • todoTaskListIdstringобязательный

    Значение для сегмента пути 'todoTaskListId'. Передавайте его под именем 'todoTaskListId', а не как 'id'. Используйте поле 'id' объекта списка задач todo, возвращаемое Microsoft Graph.

delete-todo-task-listвнешний мир

Удаляет объект todoTaskList. 💡 СОВЕТ: Удаляет список задач Microsoft To Do. Встроенные списки (Flagged emails, список задач по умолчанию) нельзя удалить - API возвращает ошибку для них. Получайте идентификаторы списков через list-todo-task-lists.

Параметры
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstring

    ETag

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • todoTaskListIdstringобязательный

    Значение для сегмента пути 'todoTaskListId'. Передавайте его под именем 'todoTaskListId', а не как 'id'. Используйте поле 'id' объекта списка задач todo, возвращаемое Microsoft Graph.

dismiss-calendar-event-reminderвнешний мир

Отклоняет напоминание, которое было вызвано для события в календаре пользователя. 💡 СОВЕТ: Отклоняет сработавшее напоминание о событии, чтобы оно не сработало повторно. Тело запроса не требуется. Используйте совместно с list-calendar-events или get-schedule для поиска активных напоминаний.

Параметры
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • eventIdstringобязательный

    Значение для сегмента пути 'eventId'. Передавайте его под именем 'eventId', а не как 'id'. Используйте поле 'id' объекта события, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

download-bytesтолько чтениевнешний мир

Скачивает бинарное содержимое из Microsoft Graph и возвращает его в base64. Единственный инструмент для любого чтения бинарных данных: содержимое файла на диске, вложение письма, фото профиля, размещённое содержимое Teams, запись встречи. Возвращает { contentType, encoding: "base64", contentLength, contentBytes }. Для больших файлов на диске или в SharePoint лучше взять get-download-url: он возвращает заранее аутентифицированный URL, чтобы отдавать байты в обход контекста агента, а не гнать base64 через него. Если на сервере включён вывод blob, байты приходят как файловый ресурс (с ограничением по серверному лимиту скачивания); передайте fileName, чтобы задать ему имя.

Параметры
  • fileNamestring

    Имя файла, используется как последний сегмент возвращаемого URI ресурса, когда сервер работает с выводом blob. Необязательно.

  • targetstringобязательный

    Относительный путь Microsoft Graph, начинающийся с "/". Частые пути: /drives/{drive-id}/items/{driveItem-id}/content (содержимое файла на диске); /me/messages/{message-id}/attachments/{attachment-id}/$value (вложение почты, list-mail-attachments возвращает идентификаторы); /me/photo/$value или /users/{user-id}/photo/$value (фото профиля); /chats/{chat-id}/messages/{chatMessage-id}/hostedContents/{chatMessageHostedContent-id}/$value (размещённое содержимое чата Teams, list-chat-message-hosted-contents возвращает идентификаторы); /teams/{team-id}/channels/{channel-id}/messages/{chatMessage-id}/hostedContents/{chatMessageHostedContent-id}/$value (размещённое содержимое канала Teams). Для записей собраний используйте get-meeting-recording-content, где доступно; Microsoft Graph возвращает аутентифицированные байты записи, а не предварительно авторизованный URL для скачивания.

download-bytes-to-fileтолько чтениевнешний мир

Записывает аутентифицированное байтовое содержимое Microsoft Graph в локальный файл на сервере, возвращая { path, contentType, bytesWritten } вместо base64. Единственный out-of-band способ сохранить вложения почты и записи собраний, байты которых доступны только через аутентифицированные конечные точки. Также обрабатывает фотографии профиля и контент, размещённый в Teams. Записывает в абсолютный путь outputPath и никогда не перезаписывает существующий файл. stdio-режим или HTTP с --http-local-file-tools. Для содержимого файлов OneDrive или SharePoint предпочтителен get-download-url: он возвращает URL с предварительной аутентификацией, загрузка идёт полностью out-of-band, серверу не нужно получать байты.

Параметры
  • outputPathstringобязательный

    Абсолютный путь в файловой системе сервера, куда записываются байты, например, /Users/me/downloads/invoice.pdf. Путь должен быть абсолютным; относительные пути отклоняются. Родительский каталог должен уже существовать, а существующий файл никогда не перезаписывается (вызов завершается ошибкой, если outputPath уже существует).

  • targetstringобязательный

    Относительный путь Microsoft Graph, начинающийся с "/". Частые пути: /drives/{drive-id}/items/{driveItem-id}/content (содержимое файла на диске); /me/messages/{message-id}/attachments/{attachment-id}/$value (вложение почты, list-mail-attachments возвращает идентификаторы); /me/photo/$value или /users/{user-id}/photo/$value (фото профиля); /chats/{chat-id}/messages/{chatMessage-id}/hostedContents/{chatMessageHostedContent-id}/$value (размещённое содержимое чата Teams, list-chat-message-hosted-contents возвращает идентификаторы); /teams/{team-id}/channels/{channel-id}/messages/{chatMessage-id}/hostedContents/{chatMessageHostedContent-id}/$value (размещённое содержимое канала Teams). Для записей собраний используйте get-meeting-recording-content, где доступно; Microsoft Graph возвращает аутентифицированные байты записи, а не предварительно авторизованный URL для скачивания.

format-excel-rangeвнешний мир

Форматирует диапазон Excel. 💡 СОВЕТ: Применяет свойства rangeFormat к конкретному диапазону. Обязательный параметр пути 'address' (например, 'A1:E5' или 'Sheet1!A1:E5'). Тело запроса: { horizontalAlignment, verticalAlignment, wrapText, columnWidth, rowHeight }. Шрифт, заливка и границы здесь НЕ задаются; используйте format-excel-range-font, format-excel-range-fill и format-excel-range-border для этого.

Параметры
  • addressstringобязательный

    Значение для сегмента пути 'address'.

  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • workbookWorksheetIdstringобязательный

    Значение для сегмента пути 'workbookWorksheetId'. Передавайте его под именем 'workbookWorksheetId', а не как 'id'. Используйте поле 'id' объекта рабочего листа книги, возвращаемого Microsoft Graph.

format-excel-range-borderвнешний мир

Форматирует границу диапазона Excel. 💡 СОВЕТ: Устанавливает одну сторону границы. Параметр пути {sideIndex} выбирает сторону: EdgeTop, EdgeBottom, EdgeLeft, EdgeRight, InsideVertical, InsideHorizontal, DiagonalDown или DiagonalUp. Чтобы обвести все четыре края, вызовите один раз для каждой стороны.

Параметры
  • addressstringобязательный

    Значение для сегмента пути 'address'.

  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • sideIndexstringобязательный

    Значение для сегмента пути 'sideIndex'.

  • workbookWorksheetIdstringобязательный

    Значение для сегмента пути 'workbookWorksheetId'. Передавайте его под именем 'workbookWorksheetId', а не как 'id'. Используйте поле 'id' объекта рабочего листа книги, возвращаемого Microsoft Graph.

format-excel-range-fillвнешний мир

Форматирует заливку диапазона Excel. 💡 СОВЕТ: Установите цвет фоновой заливки ячеек диапазона.

Параметры
  • addressstringобязательный

    Значение для сегмента пути 'address'.

  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • workbookWorksheetIdstringобязательный

    Значение для сегмента пути 'workbookWorksheetId'. Передавайте его под именем 'workbookWorksheetId', а не как 'id'. Используйте поле 'id' объекта рабочего листа книги, возвращаемого Microsoft Graph.

format-excel-range-fontвнешний мир

Форматирует шрифт диапазона Excel. 💡 СОВЕТ: Установите форматирование шрифта для диапазона: жирный, курсив, подчеркивание, размер, цвет и название шрифта.

Параметры
  • addressstringобязательный

    Значение для сегмента пути 'address'.

  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • workbookWorksheetIdstringобязательный

    Значение для сегмента пути 'workbookWorksheetId'. Передавайте его под именем 'workbookWorksheetId', а не как 'id'. Используйте поле 'id' объекта рабочего листа книги, возвращаемого Microsoft Graph.

forward-calendar-eventвнешний мир

Это действие позволяет организатору или участнику встречи переслать запрос на встречу новому получателю. Если запрос на встречу пересылается из почтового ящика участника Microsoft 365 другому получателю, это действие также отправляет уведомление организатору о пересылке и добавляет получателя в копию встречи организатора. Эта возможность недоступна при пересылке из учётной записи Outlook.com. 💡 ПОДСКАЗКА: Пересылает приглашение на встречу дополнительным получателям. Body: { ToRecipients: [{ emailAddress: { address, name } }], Comment (необязательно) }. Если отправитель пересылки является участником (не организатором), организатор также уведомляется, и новый получатель добавляется в список участников организатора.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • eventIdstringобязательный

    Значение для сегмента пути 'eventId'. Передавайте его под именем 'eventId', а не как 'id'. Используйте поле 'id' объекта события, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

forward-mail-messageвнешний мир

Пересылает сообщение в формате JSON или MIME. При использовании JSON: - Укажите либо comment, либо свойство body параметра message. Указание обоих вернёт ошибку HTTP 400 Bad Request. - Укажите либо параметр toRecipients, либо свойство toRecipients параметра message. Указание обоих или отсутствие обоих вернёт ошибку HTTP 400 Bad Request. При использовании MIME: - Передайте соответствующие заголовки интернет-сообщения и MIME-содержимое, закодированные в base64, в теле запроса. - Добавьте любые вложения и свойства S/MIME в MIME-содержимое. Этот метод сохраняет сообщение в папке «Отправленные». Как альтернатива, создайте черновик для пересылки сообщения и отправьте его позже. 💡 СОВЕТ: Пересылает письмо с сохранением полного HTML-форматирования и вложений. Поле 'comment' добавляет текст над пересылаемым содержимым. toRecipients обязателен. НЕ восстанавливайте письмо вручную — этот эндпоинт обрабатывает всё на стороне сервера.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • messageIdstringобязательный

    Значение для сегмента пути 'messageId'. Передавайте его под именем 'messageId', а не как 'id'. Используйте поле 'id' объекта сообщения, возвращаемое Microsoft Graph.

get-calendar-eventтолько чтениевнешний мир

Получает свойства и связи указанного объекта события. В настоящее время эта операция возвращает тела событий только в формате HTML. Есть два сценария, в которых приложение может получить событие в календаре другого пользователя: поскольку ресурс событий поддерживает расширения, вы также можете использовать операцию GET для получения пользовательских свойств и данных расширений в экземпляре события.

Параметры
  • eventIdstringобязательный

    Значение для сегмента пути 'eventId'. Передавайте его под именем 'eventId', а не как 'id'. Используйте поле 'id' объекта события, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • expandExtendedPropertiesboolean

    При значении true разворачивает singleValueExtendedProperties для каждого события. Используйте этот параметр, чтобы получить настраиваемые расширенные свойства (например, метаданные синхронизации), хранящиеся в событиях календаря.

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • timezonestring

    Название часового пояса IANA (например, «America/New_York», «Europe/London», «Asia/Tokyo») для времени событий календаря. Если не указано, время возвращается в UTC.

get-calendar-viewтолько чтениевнешний мир

Получает вхождения, исключения и отдельные экземпляры событий в представлении календаря, заданном временным диапазоном, из календаря пользователя по умолчанию или из любого другого календаря пользователя. 💡 СОВЕТ: Возвращает развёрнутые экземпляры повторяющихся событий (не только seriesMaster) в пределах диапазона дат для календаря по умолчанию. Требует параметры запроса startDateTime и endDateTime в формате ISO 8601 (например, 2024-01-01T00:00:00Z). Используйте get-specific-calendar-view, если нужен календарь, отличный от календаря по умолчанию. Чтобы найти собрания Teams, используйте $select=subject,start,isOnlineMeeting,onlineMeetingProvider,onlineMeeting и оставьте события, у которых isOnlineMeeting равно true и onlineMeetingProvider равно teamsForBusiness; ни одно из этих свойств не фильтруется (isOnlineMeeting возвращает 400 ErrorInvalidProperty). Чтобы искать по теме, используйте $filter=contains(subject,'keyword'). Собрания Teams предоставляют ссылку для входа как onlineMeeting/joinUrl; у ресурса event нет свойства joinWebUrl. Передайте этот joinUrl в list-online-meetings как $filter=JoinWebUrl eq '{url}', чтобы получить доступ к расшифровкам.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • endDateTimestringобязательный

    Конечная дата и время временного диапазона в формате ISO 8601. Например, 2019-11-08T20:00:00-08:00

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • expandExtendedPropertiesboolean

    При значении true разворачивает singleValueExtendedProperties для каждого события. Используйте этот параметр, чтобы получить настраиваемые расширенные свойства (например, метаданные синхронизации), хранящиеся в событиях календаря.

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • startDateTimestringобязательный

    Дата и время начала временного диапазона, указанные в формате ISO 8601. Например, 2019-11-08T19:00:00-08:00

  • timezonestring

    Название часового пояса IANA (например, «America/New_York», «Europe/London», «Asia/Tokyo») для времени событий календаря. Если не указано, время возвращается в UTC.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

get-current-userтолько чтениевнешний мир

Извлекает свойства и связи объекта user. По умолчанию эта операция возвращает только подмножество наиболее часто используемых свойств для каждого user. Эти свойства по умолчанию указаны в разделе Properties. Чтобы получить свойства, которые не возвращаются по умолчанию, выполните операцию GET для user и укажите свойства в параметре запроса OData $select. Поскольку ресурс user поддерживает расширения, вы также можете использовать операцию GET для получения настраиваемых свойств и данных расширения в экземпляре user. Клиенты через Microsoft Entra ID for customers также могут использовать эту операцию API для получения своих данных.

Параметры
  • ConsistencyLevelstring

    Указывает запрошенный уровень согласованности. URL документации: https://docs.microsoft.com/graph/aad-advanced-queries

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

get-download-urlтолько чтениевнешний мир

Разрешает кратковременный предварительно аутентифицированный URL для скачивания бинарного контента Microsoft Graph, который предоставляет содержимое файлов (файлы drive/SharePoint). Возвращённый URL передаёт байты БЕЗ заголовка Authorization, поэтому клиент может получить его сразу на диск (например, через curl) без передачи base64 через контекст агента. Предпочитайте этот инструмент download-bytes для любых файлов размером более нескольких КБ или при массовой загрузке. Возвращает { downloadUrl, name?, size?, contentType? }. Вложения файлов почты (/messages/{id}/attachments/{id}/$value), записи встреч и другие конечные точки байтовых данных $value не имеют предварительно аутентифицированного URL от самого Graph, но всё равно вызывайте этот инструмент для них: сервер, запущенный с флагом --enable-attachment-urls, создаёт для них собственный одноразовый URL, а сервер без него отвечает с указанием причины и направляет к download-bytes.

Параметры
  • targetstringобязательный

    Относительный путь Microsoft Graph, начинающийся с "/". Либо путь к содержимому driveItem, либо сам путь к элементу, например /drives/{drive-id}/items/{driveItem-id}/content, /me/drive/items/{driveItem-id}/content или /sites/{site-id}/drive/items/{driveItem-id}. Завершающий /content необязателен и автоматически отбрасывается для элементов диска. Пути $value почтовых вложений и записи встреч принимаются на сервере, запущенном с --enable-attachment-urls.

get-drive-deltaтолько чтениевнешний мир

Отслеживает изменения в driveItem и его дочерних элементах с течением времени. Ваше приложение начинает с вызова delta без параметров. Служба начинает перечисление иерархии диска, возвращая страницы элементов и либо @odata.nextLink, либо @odata.deltaLink, как описано ниже. Приложение должно продолжать вызывать с @odata.nextLink, пока вы больше не увидите возвращаемый @odata.nextLink или не увидите ответ с пустым набором изменений. После того как вы закончите получать все изменения, вы можете применить их к своему локальному состоянию. Чтобы проверять изменения в будущем, снова вызовите delta с @odata.deltaLink из предыдущего ответа. Удаленные элементы возвращаются с аспектом deleted. Элементы с этим установленным свойством следует удалить из вашего локального состояния. 💡 СОВЕТ: Отслеживает изменения в driveItem и его дочерних элементах с течением времени. Возвращает коллекцию driveItems, которые были созданы, изменены или удалены. Сначала используйте get-drive-root-item, чтобы получить корневой driveItem-id, затем передайте его сюда. Поддерживает $select и delta tokens для инкрементальной синхронизации через @odata.deltaLink.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

get-drive-itemтолько чтениевнешний мир

Все элементы, содержащиеся в диске. Только для чтения. Может быть null. 💡 СОВЕТ: Получает метаданные файла или папки: name, size, lastModifiedDateTime, createdBy, webUrl, file (mimeType, hashes), folder (childCount), parentReference и @microsoft.graph.downloadUrl. Для больших файлов на диске или в SharePoint вызовите get-download-url с target=/drives/{drive-id}/items/{driveItem-id}/content, чтобы загрузить данные внеполосно (без заголовка Authorization). Для небольших файлов, если base64 в ответе инструмента приемлем, вызовите download-bytes с тем же целевым путем /content.

Параметры
  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

get-drive-root-itemтолько чтениевнешний мир

Корневая папка диска. Только для чтения.

Параметры
  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

get-excel-rangeтолько чтениевнешний мир

Получает диапазон Excel.

Параметры
  • addressstringобязательный

    Значение для сегмента пути 'address'.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • workbookWorksheetIdstringобязательный

    Значение для сегмента пути 'workbookWorksheetId'. Передавайте его под именем 'workbookWorksheetId', а не как 'id'. Используйте поле 'id' объекта рабочего листа книги, возвращаемого Microsoft Graph.

get-excel-range-formatтолько чтениевнешний мир

Возвращает объект формата, инкапсулирующий шрифт, заливку, границы, выравнивание и другие свойства диапазона. Только для чтения. 💡 СОВЕТ: Читает формат диапазона: alignment, wrapText, columnWidth, rowHeight. Шрифт, заливка и границы вложены и по умолчанию опущены; добавьте font, fill и borders в параметр $expand, чтобы включить их за один вызов. Оформление ячеек часто кодирует смысл (цвет заливки или шрифта помечает статус, например «предварительный» или «согласованный»), поэтому раскрывайте эти свойства, чтобы интерпретировать, что означают ячейки.

Параметры
  • addressstringобязательный

    Значение для сегмента пути 'address'.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • workbookWorksheetIdstringобязательный

    Значение для сегмента пути 'workbookWorksheetId'. Передавайте его под именем 'workbookWorksheetId', а не как 'id'. Используйте поле 'id' объекта рабочего листа книги, возвращаемого Microsoft Graph.

get-excel-tableтолько чтениевнешний мир

Представляет коллекцию таблиц, связанных с рабочей книгой. Только для чтения. 💡 СОВЕТ: Получает конкретную таблицу по имени или ID. Возвращает свойства таблицы, включая columns, showHeaders, showTotals и style.

Параметры
  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • workbookTableIdstringобязательный

    Значение для сегмента пути 'workbookTableId'. Передавайте его под именем 'workbookTableId', а не как 'id'. Используйте поле 'id' объекта таблицы книги, которое возвращает Microsoft Graph.

get-excel-used-rangeтолько чтениевнешний мир

Получает использованный диапазон Excel. 💡 СОВЕТ: Получает наименьший диапазон, охватывающий все ячейки с данными или форматированием на листе. Возвращает адрес, значения, формулы, numberFormat, количество строк, количество столбцов. Используйте этот диапазон, чтобы определить заполненные границы листа перед чтением или добавлением данных - избавляет от необходимости угадывать, насколько далеко простираются данные. Опциональный $select для сужения возвращаемых полей.

Параметры
  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • workbookWorksheetIdstringобязательный

    Значение для сегмента пути 'workbookWorksheetId'. Передавайте его под именем 'workbookWorksheetId', а не как 'id'. Используйте поле 'id' объекта рабочего листа книги, возвращаемого Microsoft Graph.

get-mail-attachment-contentтолько чтениевнешний мир

Скачивает необработанные байты файлового вложения сообщения Outlook в почтовом ящике пользователя, выполнившего вход, по ID сообщения и ID вложения. 💡 СОВЕТ: Сначала нужно найти ID вложения с помощью list-mail-attachments. Если на сервере включён вывод blob, байты возвращаются как файловый ресурс; передайте fileName (имя вложения), чтобы задать имя. Файлы, превышающие лимит скачивания на сервере, отклоняются с ошибкой, в которой указан лимит.

Параметры
  • attachmentIdstringобязательный

    Значение для сегмента пути 'attachmentId'. Передавайте его под именем 'attachmentId', а не как 'id'. Используйте поле 'id' объекта вложения, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • fileNamestring

    Имя файла, используется как последний сегмент возвращаемого URI ресурса, когда сервер работает с выводом blob. Необязательно.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • messageIdstringобязательный

    Значение для сегмента пути 'messageId'. Передавайте его под именем 'messageId', а не как 'id'. Используйте поле 'id' объекта сообщения, возвращаемое Microsoft Graph.

get-mailbox-settingsтолько чтениевнешний мир

Получает настройки почтового ящика пользователя. Можно просмотреть все настройки почтового ящика или получить конкретные. Пользователи могут задать следующие настройки для своих почтовых ящиков через клиент Outlook: пользователи могут установить предпочитаемые форматы даты и времени с помощью Outlook в Интернете. Пользователь выбирает один из поддерживаемых форматов короткой даты или короткого времени. Эта операция GET возвращает выбранный пользователем формат. Пользователи могут задать предпочитаемый часовой пояс в любом клиенте Outlook, выбрав один из поддерживаемых часовых поясов, которые администратор настроил для их почтового сервера. Администратор может настроить часовые пояса в формате часовых поясов Windows или в формате часовых поясов Internet Assigned Numbers Authority (IANA) (также известных как часовые пояса Olson). Формат Windows используется по умолчанию. Эта операция GET возвращает предпочитаемый часовой пояс пользователя в том формате, который настроил администратор. Если вы хотите получить часовой пояс в определённом формате (Windows или IANA), вы можете сначала обновить предпочитаемый часовой пояс в этом формате как настройку почтового ящика. Затем вы сможете получить часовой пояс в этом формате. Или вы можете управлять преобразованием формата отдельно в своём приложении. 💡 Подсказка: Получает настройки почтового ящика текущего пользователя, включая automaticRepliesSetting (статус отсутствия на работе, сообщение, scheduledStartDateTime/EndDateTime, externalAudience), language, timeZone, dateFormat, timeFormat, delegateMeetingMessageDeliveryOptions и workingHours.

Параметры
  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

get-mail-messageтолько чтениевнешний мир

Получает одно письмо Outlook по его идентификатору, включая полную тему, отправителя, получателей, содержимое и флаги вложений. Сначала используйте list-mail-messages, чтобы получить идентификатор письма.

Параметры
  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • messageIdstringобязательный

    Значение для сегмента пути 'messageId'. Передавайте его под именем 'messageId', а не как 'id'. Используйте поле 'id' объекта сообщения, возвращаемое Microsoft Graph.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

get-mail-message-mimeтолько чтениевнешний мир

Скачивает исходный MIME-контент (содержимое .eml в формате RFC 5322) письма Outlook по идентификатору сообщения. Возвращает полное исходное сообщение, включая заголовки и закодированные вложения. 💡 СОВЕТ: Скачайте письмо как исходный контент RFC 5322 MIME (формат .eml). Используйте это при архивировании письма на диск, сохраняя все исходные заголовки, тело и встроенные закодированные вложения. Возвращает MIME-поток как текст. Сначала найдите идентификатор сообщения с помощью list-mail-messages.

Параметры
  • Acceptstring

    Заголовок Accept определяет представление ответа. По умолчанию: "text/plain". Устанавливайте его только тогда, когда Graph запрашивает другой формат, например, ошибка 403 SpeakerAttributionNotAllowed в содержимом транскрипта указывает тип носителя, с которым нужно повторить попытку.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • fileNamestring

    Имя файла, используется как последний сегмент возвращаемого URI ресурса, когда сервер работает с выводом blob. Необязательно.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • includeHiddenMessagesstring

    Включает скрытые сообщения.

  • messageIdstringобязательный

    Значение для сегмента пути 'messageId'. Передавайте его под именем 'messageId', а не как 'id'. Используйте поле 'id' объекта сообщения, возвращаемое Microsoft Graph.

get-mail-tipsтолько чтениевнешний мир

Получает MailTips одного или нескольких получателей, доступные вошедшему в систему пользователю. Обратите внимание, что с помощью POST-вызова действия getMailTips вы можете запросить определённые типы MailTips для нескольких получателей одновременно. Запрошенные MailTips возвращаются в коллекции mailTips. 💡 СОВЕТ: Просматривает MailTips для одного или нескольких получателей перед отправкой письма — отвечает на вопросы: «этот человек в автоответе / OOF?», «превысит ли моё письмо его квоту почтового ящика?», «является ли он внешним получателем?», «это почтовый ящик или список рассылки?». Тело: { EmailAddresses: ['user@contoso.com', ...], MailTipsOptions: 'automaticReplies, mailboxFullStatus, customMailTip, externalMemberCount, totalMemberCount, maxMessageSize, deliveryRestriction, moderationStatus, recipientScope, recipientSuggestions' (подмножество через запятую) }. Возвращает MailTips для каждого получателя с заполненными запрошенными полями. Используйте это, чтобы не отправлять срочные письма, когда получатель в OOF, или чтобы предупредить перед рассылкой большому числу адресатов.

Параметры
  • bodyobjectобязательный
  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

get-my-profileтолько чтениевнешний мир

[beta] Получает свойства и связи объекта profile для заданного пользователя. Ресурс profile предоставляет различные расширенные свойства, описывающие пользователя в виде связей, например, годовщины и сведения об образовании. Чтобы получить одно из этих навигационных свойств, используйте соответствующий метод GET для этого свойства. Смотрите методы, предоставляемые profile. 💡 СОВЕТ: Получает расширенный профиль вошедшего в систему пользователя — более богатый объект, чем get-current-user, предоставляющий связи, такие как навыки, проекты, языки, образование и места работы. Используйте $expand для извлечения связанных коллекций (например, $expand=skills,projects,languages,education,workPositions).

Параметры
  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

get-onenote-page-contentтолько чтениевнешний мир

HTML-содержимое страницы.

Параметры
  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • onenotePageIdstringобязательный

    Значение для сегмента пути 'onenotePageId'. Передавайте его под именем 'onenotePageId', а не как 'id'. Используйте поле 'id' объекта страницы OneNote, возвращаемое Microsoft Graph.

get-outlook-contactтолько чтениевнешний мир

Извлекает свойства и связи объекта контакта. Есть два сценария, при которых приложение может получить контакт из папки контактов другого пользователя:

Параметры
  • contactIdstringобязательный

    Значение для сегмента пути 'contactId'. Передавайте его под именем 'contactId', а не как 'id'. Используйте поле 'id' объекта контакта, возвращаемого Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

get-planner-bucketтолько чтениевнешний мир

Получает свойства и связи объекта plannerBucket. 💡 СОВЕТ: Ответ включает @odata.etag — требуется в качестве If-Match для update-planner-bucket и delete-planner-bucket. Используйте includeHeaders=true.

Параметры
  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • plannerBucketIdstringобязательный

    Значение для сегмента пути 'plannerBucketId'. Передавайте его под именем 'plannerBucketId', а не как 'id'. Используйте поле 'id' объекта bucket планировщика, возвращаемого Microsoft Graph.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

get-planner-planтолько чтениевнешний мир

Получает свойства и связи объекта plannerplan.

Параметры
  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • plannerPlanIdstringобязательный

    Значение для сегмента пути 'plannerPlanId'. Передавайте его под именем 'plannerPlanId', а не 'id'. Используйте поле 'id' объекта planner plan, возвращаемого Microsoft Graph.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

get-planner-taskтолько чтениевнешний мир

Получает свойства и связи объекта plannerTask. 💡 ПОДСКАЗКА: Ответ включает @odata.etag — сохраните его, требуется в качестве заголовка If-Match для update-planner-task. Используйте includeHeaders=true, чтобы получить его.

Параметры
  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • plannerTaskIdstringобязательный

    Значение для сегмента пути 'plannerTaskId'. Передавайте его под именем 'plannerTaskId', а не 'id'. Используйте поле 'id' объекта planner task, возвращаемое Microsoft Graph.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

get-planner-task-detailsтолько чтениевнешний мир

Получает свойства и связи объекта plannerTaskDetails. 💡 СОВЕТ: Ответ содержит @odata.etag — требуется для update-planner-task-details. Используйте includeHeaders=true.

Параметры
  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • plannerTaskIdstringобязательный

    Значение для сегмента пути 'plannerTaskId'. Передавайте его под именем 'plannerTaskId', а не 'id'. Используйте поле 'id' объекта planner task, возвращаемое Microsoft Graph.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

get-specific-calendar-eventтолько чтениевнешний мир

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

Параметры
  • calendarIdstringобязательный

    Значение для сегмента пути 'calendarId'. Передавайте его под именем 'calendarId', а не как 'id'. Используйте поле 'id' объекта календаря, возвращаемого Microsoft Graph.

  • eventIdstringобязательный

    Значение для сегмента пути 'eventId'. Передавайте его под именем 'eventId', а не как 'id'. Используйте поле 'id' объекта события, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • expandExtendedPropertiesboolean

    При значении true разворачивает singleValueExtendedProperties для каждого события. Используйте этот параметр, чтобы получить настраиваемые расширенные свойства (например, метаданные синхронизации), хранящиеся в событиях календаря.

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • timezonestring

    Название часового пояса IANA (например, «America/New_York», «Europe/London», «Asia/Tokyo») для времени событий календаря. Если не указано, время возвращается в UTC.

get-specific-calendar-viewтолько чтениевнешний мир

Перечисляет вхождения, исключения и одиночные экземпляры событий в пределах временного диапазона из одного из календарей вошедшего в систему пользователя, определяемого по идентификатору календаря. 💡 СОВЕТ: Возвращает развернутые экземпляры повторяющихся событий (не только seriesMaster) в пределах диапазона дат для конкретного календаря. Требует параметры запроса startDateTime и endDateTime в формате ISO 8601 (например, 2024-01-01T00:00:00Z). Каждый экземпляр включает поля seriesMasterId и type (occurrence/exception) для связи с повторяющимся событием. Используйте fetchAllPages=true, чтобы получить все результаты, когда событий много. Чтобы найти собрания Teams, используйте $select=subject,start,isOnlineMeeting,onlineMeetingProvider,onlineMeeting и оставляйте события, у которых isOnlineMeeting равно true, а onlineMeetingProvider равно teamsForBusiness; ни одно из этих свойств не фильтруется (isOnlineMeeting возвращает 400 ErrorInvalidProperty). Собрания Teams предоставляют ссылку для подключения как onlineMeeting/joinUrl; у ресурса события нет свойства joinWebUrl. Передайте эту joinUrl в list-online-meetings как $filter=JoinWebUrl eq '{url}', чтобы получить расшифровки.

Параметры
  • calendarIdstringобязательный

    Значение для сегмента пути 'calendarId'. Передавайте его под именем 'calendarId', а не как 'id'. Используйте поле 'id' объекта календаря, возвращаемого Microsoft Graph.

  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • endDateTimestringобязательный

    Конечная дата и время временного диапазона в формате ISO 8601. Например, 2019-11-08T20:00:00-08:00

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • expandExtendedPropertiesboolean

    При значении true разворачивает singleValueExtendedProperties для каждого события. Используйте этот параметр, чтобы получить настраиваемые расширенные свойства (например, метаданные синхронизации), хранящиеся в событиях календаря.

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • startDateTimestringобязательный

    Дата и время начала временного диапазона, указанные в формате ISO 8601. Например, 2019-11-08T19:00:00-08:00

  • timezonestring

    Название часового пояса IANA (например, «America/New_York», «Europe/London», «Asia/Tokyo») для времени событий календаря. Если не указано, время возвращается в UTC.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

get-subscriptionтолько чтениевнешний мир

Получает свойства и отношения подписки. См. таблицу в разделе Permissions для списка ресурсов, поддерживающих подписку на уведомления об изменениях. 💡 СОВЕТ: Получает конкретную подписку webhook по идентификатору. Используйте list-subscriptions, чтобы найти идентификатор. Возвращает полные сведения о подписке, включая resource, changeType, notificationUrl, expirationDateTime, applicationId.

Параметры
  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • subscriptionIdstringобязательный

    Значение для сегмента пути 'subscriptionId'. Передавайте его под именем 'subscriptionId', а не как 'id'. Используйте поле 'id' объекта подписки, возвращаемое Microsoft Graph.

get-todo-taskтолько чтениевнешний мир

Читает свойства и связи объекта todoTask. 💡 СОВЕТ: Возвращает одну задачу To Do. ПРИМЕЧАНИЕ: $select НЕ поддерживается: не передавайте параметр select, иначе Graph вернёт RequestBroker--ParseUri (400). Используйте $expand=linkedResources для включения связанной почты/ресурса. Возвращает содержимое тела (в формате HTML), элементы контрольного списка и связанные ресурсы.

Параметры
  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • todoTaskIdstringобязательный

    Значение для сегмента пути 'todoTaskId'. Передавайте его под именем 'todoTaskId', а не как 'id'. Используйте поле 'id' объекта задачи todo, возвращаемое Microsoft Graph.

  • todoTaskListIdstringобязательный

    Значение для сегмента пути 'todoTaskListId'. Передавайте его под именем 'todoTaskListId', а не как 'id'. Используйте поле 'id' объекта списка задач todo, возвращаемое Microsoft Graph.

get-upload-urlвнешний мир

Создаёт короткоживущий одноразовый URL, который этот сервер отдаёт для загрузки файла как вложения к черновику сообщения или событию, чтобы байты шли напрямую от вызывающего в Microsoft Graph, а не проходили как base64 через контекст агента. target - коллекция вложений элемента: /me/messages/{message-id}/attachments (черновик; сначала создайте его) или /me/events/{event-id}/attachments. Отправляет необработанные байты файла методом PUT на возвращённый uploadUrl с Content-Length (например, curl -T file "<uploadUrl>"); ответ подтверждает вложение. Файлы меньше 3 МБ прикрепляются напрямую, более крупные (до 150 МБ) - через сессию загрузки Graph. Требует --enable-attachment-urls. Возвращает { uploadUrl, method, expiresAt, singleUse, maxBytes }.

Параметры
  • contentTypestring

    MIME-тип файла, например application/pdf. По умолчанию: application/octet-stream.

  • namestringобязательный

    Имя файла вложения, как его увидит получатель, например report.pdf

  • targetstringобязательный

    Коллекция вложений черновика сообщения или события, например /me/messages/{message-id}/attachments или /me/events/{event-id}/attachments.

graph-batchвнешний мир

Объединяет до 20 запросов Graph в один HTTP-вызов. Тело: { requests: [{ id: '1', method: 'GET'|'POST'|'PATCH'|'DELETE', url: '/me/messages?$top=5', headers?: {...}, body?: {...}, dependsOn?: ['1'] }, ...] }. Возвращает { responses: [{ id, status, body, headers }] } в произвольном порядке — сопоставляйте по id. Варианты использования: (1) распараллеливание множества мелких чтений (например, получить 15 почтовых сообщений по id за один round-trip); (2) последовательность зависимых записей через dependsOn; (3) группировка множества записей диапазонов Excel в один вызов для значительного снижения задержки при сборке больших книг. Примечание: URL каждого подзапроса указывается относительно корня версии Graph (/me/..., /drives/..., НЕ https://graph.microsoft.com/v1.0/...). 💡 СОВЕТ: Объединяет до 20 запросов Graph в один HTTP-вызов. Тело: { requests: [{ id: '1', method: 'GET'|'POST'|'PATCH'|'DELETE', url: '/me/messages?$top=5', headers?: {...}, body?: {...}, dependsOn?: ['1'] }, ...] }. Возвращает { responses: [{ id, status, body, headers }] } в произвольном порядке — сопоставляйте по id. Варианты использования: (1) распараллеливание множества мелких чтений (например, получить 15 почтовых сообщений по id за один round-trip); (2) последовательность зависимых записей через dependsOn; (3) группировка множества записей диапазонов Excel в один вызов для значительного снижения задержки при сборке больших книг. Примечание: URL каждого подзапроса указывается относительно корня версии Graph (/me/..., /drives/..., НЕ https://graph.microsoft.com/v1.0/...).

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

insert-excel-rangeвнешний мир

Вставляет диапазон Excel. 💡 СОВЕТ: Вставляет пустые ячейки в указанный диапазон, смещая существующее содержимое. Body: { shift: 'Down' } или { shift: 'Right' }. Используйте 'Down', чтобы вставить пустые строки над существующими данными.

Параметры
  • addressstringобязательный

    Значение для сегмента пути 'address'.

  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • workbookWorksheetIdstringобязательный

    Значение для сегмента пути 'workbookWorksheetId'. Передавайте его под именем 'workbookWorksheetId', а не как 'id'. Используйте поле 'id' объекта рабочего листа книги, возвращаемого Microsoft Graph.

list-accountsтолько чтение

Перечисляет все учетные записи Microsoft, настроенные на этом сервере. Используйте это, чтобы узнать доступные адреса электронной почты учетных записей перед вызовами инструментов. Отражает учетные записи, добавленные во время сеанса через --login.

Параметры

Без параметров.

list-all-onenote-sectionsтолько чтениевнешний мир

Извлекает список объектов onenoteSection. 💡 СОВЕТ: Перечисляет все разделы во всех записных книжках. Вместо этого используйте list-onenote-notebook-sections, чтобы перечислить разделы в конкретной записной книжке.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-calendar-event-instancesтолько чтениевнешний мир

Вхождения повторяющейся серии, если событие является основным событием серии. Это свойство включает вхождения, которые являются частью шаблона повторения, и изменённые исключения, но не включает вхождения, отменённые из серии. Свойство навигации. Только для чтения. Допускает значение null. 💡 СОВЕТ: Разверните повторяющееся событие в отдельные вхождения в пределах диапазона дат. Требуются параметры запроса startDateTime и endDateTime в формате ISO 8601 (например, 2024-01-01T00:00:00Z). Используйте это, чтобы увидеть все вхождения повторяющегося события.

Параметры
  • calendarIdstringобязательный

    Значение для сегмента пути 'calendarId'. Передавайте его под именем 'calendarId', а не как 'id'. Используйте поле 'id' объекта календаря, возвращаемого Microsoft Graph.

  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • endDateTimestringобязательный

    Конечная дата и время временного диапазона в формате ISO 8601. Например, 2019-11-08T20:00:00-08:00

  • eventIdstringобязательный

    Значение для сегмента пути 'eventId'. Передавайте его под именем 'eventId', а не как 'id'. Используйте поле 'id' объекта события, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • expandExtendedPropertiesboolean

    При значении true разворачивает singleValueExtendedProperties для каждого события. Используйте этот параметр, чтобы получить настраиваемые расширенные свойства (например, метаданные синхронизации), хранящиеся в событиях календаря.

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • startDateTimestringобязательный

    Дата и время начала временного диапазона, указанные в формате ISO 8601. Например, 2019-11-08T19:00:00-08:00

  • timezonestring

    Название часового пояса IANA (например, «America/New_York», «Europe/London», «Asia/Tokyo») для времени событий календаря. Если не указано, время возвращается в UTC.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-calendar-eventsтолько чтениевнешний мир

Получает список объектов событий в почтовом ящике пользователя. Список содержит отдельные встречи и основные серии (series masters). Чтобы получить развернутые экземпляры событий, можно получить представление календаря или получить экземпляры события. В настоящее время эта операция возвращает тела событий только в формате HTML. Существует два сценария, в которых приложение может получать события в календаре другого пользователя: 💡 СОВЕТ: ПРЕДУПРЕЖДЕНИЕ: НЕ разворачивает повторяющиеся события — возвращает только seriesMaster. Вместо этого используйте get-calendar-view для просмотра отдельных вхождений в серии.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • expandExtendedPropertiesboolean

    При значении true разворачивает singleValueExtendedProperties для каждого события. Используйте этот параметр, чтобы получить настраиваемые расширенные свойства (например, метаданные синхронизации), хранящиеся в событиях календаря.

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • timezonestring

    Название часового пояса IANA (например, «America/New_York», «Europe/London», «Asia/Tokyo») для времени событий календаря. Если не указано, время возвращается в UTC.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-calendar-events-deltaтолько чтениевнешний мир

Получает набор ресурсов событий, которые были добавлены, удалены или обновлены в calendarView (диапазон событий, заданный датами начала и окончания) основного календаря пользователя. Обычно синхронизация событий в calendarView в локальном хранилище включает серию из нескольких дельта-вызовов. Первый вызов — полная синхронизация, каждый последующий дельта-вызов в той же серии получает инкрементальные изменения (добавления, удаления или обновления). Так вы поддерживаете и синхронизируете локальное хранилище событий в указанном calendarView, не загружая все события этого календаря с сервера каждый раз. 💡 СОВЕТ: Инкрементальная синхронизация событий в календаре по умолчанию. Первый вызов возвращает все события и @odata.deltaLink. Последующие вызовы с этой ссылкой возвращают только добавления/обновления/удаления. Используйте $select, чтобы ограничить поля. Дельта истекает через ~30 дней — начните заново, если сервер возвращает 410 Gone. Для ограниченного по времени представления с дельта-семантикой используйте list-calendar-view-delta.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • endDateTimestringобязательный

    Конечная дата и время временного диапазона в функции, представленные в формате ISO 8601. Например, 2019-11-08T20:00:00-08:00

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • startDateTimestringобязательный

    Начальная дата и время временного диапазона в функции, представленные в формате ISO 8601. Например, 2019-11-08T20:00:00-08:00

list-calendarsтолько чтениевнешний мир

Получает все календари пользователя (свойство навигации /calendars), получает календари из группы календарей по умолчанию или из конкретной группы календарей.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-calendar-view-deltaтолько чтениевнешний мир

Получает набор ресурсов событий, которые были добавлены, удалены или обновлены в представлении calendarView (диапазон событий, заданный датами начала и окончания) основного календаря пользователя. Обычно синхронизация событий в calendarView в локальном хранилище включает несколько вызовов дельта-функции. Первый вызов — полная синхронизация, а каждый последующий вызов дельты в том же раунде получает инкрементальные изменения (добавления, удаления или обновления). Это позволяет поддерживать и синхронизировать локальное хранилище событий в указанном calendarView, без необходимости каждый раз загружать все события этого календаря с сервера. 💡 СОВЕТ: Инкрементальная синхронизация событий в пределах временного окна. Обязательные параметры запроса при первом вызове: startDateTime, endDateTime (ISO 8601). Возвращает события в окне плюс @odata.deltaLink; последующие вызовы с этой ссылкой возвращают только изменения. Разворачивает повторяющиеся события в отдельные экземпляры (в отличие от list-calendar-events-delta, который возвращает основное повторяющееся событие). Используйте для календарных интерфейсов, показывающих диапазон дат.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • endDateTimestringобязательный

    Конечная дата и время временного диапазона в функции, представленные в формате ISO 8601. Например, 2019-11-08T20:00:00-08:00

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • startDateTimestringобязательный

    Начальная дата и время временного диапазона в функции, представленные в формате ISO 8601. Например, 2019-11-08T20:00:00-08:00

  • timezonestring

    Название часового пояса IANA (например, «America/New_York», «Europe/London», «Asia/Tokyo») для времени событий календаря. Если не указано, время возвращается в UTC.

list-contact-folder-child-foldersтолько чтениевнешний мир

Получает коллекцию дочерних папок в указанной контактной папке. 💡 ПОДСКАЗКА: Перечисляет непосредственные подпапки в заданной контактной папке. Возвращает id, displayName, parentFolderId. Используйте list-contact-folders, чтобы найти папки верхнего уровня, а затем этот инструмент, чтобы спуститься на один уровень глубже. Поддерживает $filter, $top, $orderby. Примечание: контактные папки обычно представляют собой плоский список в клиентах Outlook, но Graph позволяет вкладывать папки с помощью этого инструмента.

Параметры
  • contactFolderIdstringобязательный

    Значение для сегмента пути 'contactFolderId'. Передавайте его под именем 'contactFolderId', а не как 'id'. Используйте поле 'id' объекта папки контактов, возвращаемое Microsoft Graph.

  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-contact-folder-contactsтолько чтениевнешний мир

Получает коллекцию контактов из папки "Контакты" по умолчанию для вошедшего в систему пользователя (.../me/contacts) или из указанной папки контактов. 💡 СОВЕТ: Выводит список контактов внутри определённой папки. Используйте вместе с list-contact-folders, чтобы узнать идентификатор папки. Примечание: существующий list-outlook-contacts (GET /me/contacts) возвращает контакты только из папки по умолчанию, используйте этот инструмент для чтения контактов из любой папки. Поддерживает $filter, $search='query', $orderby, $top, $select.

Параметры
  • contactFolderIdstringобязательный

    Значение для сегмента пути 'contactFolderId'. Передавайте его под именем 'contactFolderId', а не как 'id'. Используйте поле 'id' объекта папки контактов, возвращаемое Microsoft Graph.

  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-contact-foldersтолько чтениевнешний мир

Получает коллекцию папок контактов в папке Контакты по умолчанию вошедшего в систему пользователя. 💡 ПОДСКАЗКА: Перечисляет папки контактов Outlook пользователя (именованные контейнеры, которые организуют контакты). Всегда включает встроенную папку 'Contacts'; также отображаются папки, созданные пользователем. Возвращает id, displayName и parentFolderId. Чтобы определить папку по умолчанию, сравните displayName === 'Contacts'. Используйте это перед list-contact-folder-contacts или create-contact-in-folder для поиска идентификаторов папок. Поддерживает OData-запросы.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-drive-item-permissionsтолько чтениевнешний мир

Набор разрешений для элемента. Только для чтения. Допускает значение null. 💡 СОВЕТ: Перечисляет все разрешения (ссылки для общего доступа, прямой доступ, унаследованные) для файла или папки. Каждое разрешение имеет роли, grantedTo (пользователь), link (URL общего доступа) и inheritedFrom.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-drive-item-thumbnailsтолько чтениевнешний мир

Коллекция объектов thumbnailSet, связанных с элементом. Для получения дополнительной информации см. раздел getting thumbnails. Только для чтения. Допускает значение null. 💡 СОВЕТ: Перечисляет наборы миниатюр для файла. Каждый набор содержит миниатюры маленького (96px), среднего (176px), большого (800px) размера с URL и размерами. Возвращает пустой результат для неподдерживаемых типов (текстовые документы). Используйте $select=small,medium,large или $expand=small($select=url) для получения конкретных размеров. Возвращаемые URL-адреса имеют короткий срок действия — загружайте данные немедленно.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-drive-item-versionsтолько чтениевнешний мир

Список предыдущих версий элемента. Подробнее см. в разделе получения предыдущих версий. Только для чтения. Допускает значение null. 💡 СОВЕТ: Выводит историю версий файла. У каждой версии есть id, lastModifiedDateTime, lastModifiedBy и size. Используйте идентификатор версии с /versions/{id}/content, чтобы скачать конкретную версию.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-drivesтолько чтениевнешний мир

Получает список ресурсов Drive, доступных для целевого пользователя, группы или сайта.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-excel-table-rowsтолько чтениевнешний мир

Список всех строк в таблице. Только для чтения. 💡 СОВЕТ: Перечисляет все строки в таблице. Каждая строка содержит индекс и значения (массив значений ячеек). Используйте $top и $skip для постраничной навигации по большим таблицам.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

  • workbookTableIdstringобязательный

    Значение для сегмента пути 'workbookTableId'. Передавайте его под именем 'workbookTableId', а не как 'id'. Используйте поле 'id' объекта таблицы книги, которое возвращает Microsoft Graph.

list-excel-tablesтолько чтениевнешний мир

Коллекция таблиц, связанных с рабочей книгой. Только для чтения. 💡 СОВЕТ: Перечисляет все именованные таблицы в рабочей книге. Каждая таблица имеет id, name, showHeaders, showTotals, columns и style. Используйте имя таблицы или id с другими endpoints таблицы.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-excel-worksheetsтолько чтениевнешний мир

Представляет коллекцию листов, связанных с рабочей книгой. Только для чтения.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-focused-inbox-overridesтолько чтениевнешний мир

Получает переопределения, которые пользователь настроил для постоянной классификации сообщений от определённых отправителей определённым образом. Каждое переопределение соответствует SMTP-адресу отправителя. Изначально у пользователя нет переопределений. 💡 СОВЕТ: Перечисляет переопределения классификации Focused Inbox — явные правила, которые принудительно помещают сообщения от заданного отправителя (по SMTP-адресу) на вкладку Focused или Other, независимо от того, что предсказал бы классификатор Outlook ML. Каждое переопределение содержит id, classifyAs ('focused' или 'other') и senderEmailAddress {name, address}. Возвращает пустую коллекцию, если пользователь никогда не задавал переопределения.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-folder-filesтолько чтениевнешний мир

Возвращает коллекцию DriveItems в отношении children для DriveItem. DriveItems с непустым аспектом folder или package могут иметь один или несколько дочерних DriveItems.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-mail-attachmentsтолько чтениевнешний мир

Получает список объектов вложений. 💡 СОВЕТ: Выводит список вложений сообщения: id, name, contentType, size, isInline. Чтобы загрузить байты, вызовите download-bytes с параметром target=/me/messages/{message-id}/attachments/{attachment-id}/$value (суффикс /$value возвращает необработанные байты; простой URL вложения встраивает contentBytes в JSON, что может обрезать большие файлы).

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • messageIdstringобязательный

    Значение для сегмента пути 'messageId'. Передавайте его под именем 'messageId', а не как 'id'. Используйте поле 'id' объекта сообщения, возвращаемое Microsoft Graph.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-mail-child-foldersтолько чтениевнешний мир

Получает коллекцию папок в указанной папке. Вы можете использовать сокращение .../me/mailFolders, чтобы получить коллекцию папок верхнего уровня и перейти к другой папке. По умолчанию эта операция не возвращает скрытые папки. Используйте параметр запроса includeHiddenFolders, чтобы включить их в ответ.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • includeHiddenFoldersstring

    Включать скрытые папки

  • mailFolderIdstringобязательный

    Значение для сегмента пути 'mailFolderId'. Передавайте его под именем 'mailFolderId', а не как 'id'. Используйте поле 'id' объекта почтовой папки, возвращаемое Microsoft Graph.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-mail-folder-messagesтолько чтениевнешний мир

Получает все сообщения в почтовом ящике указанного пользователя или сообщения в указанной папке этого почтового ящика. 💡 СОВЕТ: Выводит список, читает и ищет письма Outlook в указанной почтовой папке. КРИТИЧНО: При поиске писем значение параметра $search ОБЯЗАТЕЛЬНО должно быть заключено в двойные кавычки. Формат: $search="ваш поисковый запрос здесь". Используйте синтаксис KQL (Keyword Query Language) для поиска по конкретным свойствам: 'from:', 'subject:', 'body:', 'to:', 'cc:', 'bcc:', 'attachment:', 'hasAttachments:', 'importance:', 'received:', 'sent:'. Примеры: $search="from:john@example.com" | $search="subject:meeting AND hasAttachments:true" | $search="body:urgent AND received>=2024-01-01" | $search="from:alice AND importance:high". Помните: ВСЕГДА заключайте всё поисковое выражение в двойные кавычки! Ссылка: https://learn.microsoft.com/en-us/graph/search-query-parameter ВАЖНО: Всегда используйте $select для ограничения возвращаемых полей и уменьшения размера ответа. Рекомендуемый набор по умолчанию: $select=id,subject,from,toRecipients,receivedDateTime,bodyPreview,isRead,hasAttachments. Для списков используйте bodyPreview вместо body. Чтобы прочитать полное тело письма, используйте get-mail-message с указанием идентификатора конкретного сообщения.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • mailFolderIdstringобязательный

    Значение для сегмента пути 'mailFolderId'. Передавайте его под именем 'mailFolderId', а не как 'id'. Используйте поле 'id' объекта почтовой папки, возвращаемое Microsoft Graph.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-mail-folder-messages-deltaтолько чтениевнешний мир

Получает набор сообщений, добавленных, удалённых или обновлённых в указанной папке. Вызов дельта-функции для сообщений в папке аналогичен запросу GET, за исключением того, что, правильно применяя токены состояния в одном или нескольких таких вызовах, вы можете запрашивать инкрементальные изменения сообщений в этой папке. Она позволяет поддерживать и синхронизировать локальное хранилище сообщений пользователя без необходимости каждый раз получать полный набор сообщений с сервера. 💡 СОВЕТ: Инкрементальная синхронизация сообщений в почтовой папке. Graph поддерживает дельту только в пределах папки: используйте mailFolder-id = 'inbox' для стандартного входящего, или другой идентификатор папки из list-mail-folders. Первый вызов возвращает все сообщения плюс @odata.deltaLink; последующие вызовы с этой ссылкой возвращают только изменения (созданные/обновлённые/удалённые). @odata.nextLink разбивает на страницы в рамках одного окна дельты. Дельта-токены истекают примерно через 30 дней бездействия. Начните заново, если сервер возвращает 410. Предпочитайте это полному повторному списку для опроса.

Параметры
  • changeTypestring

    Настраиваемый параметр запроса для фильтрации дельта-ответа по типу изменения. Поддерживаемые значения: created, updated или deleted.

  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • mailFolderIdstringобязательный

    Значение для сегмента пути 'mailFolderId'. Передавайте его под именем 'mailFolderId', а не как 'id'. Используйте поле 'id' объекта почтовой папки, возвращаемое Microsoft Graph.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-mail-foldersтолько чтениевнешний мир

Получает коллекцию почтовых папок, находящихся непосредственно в корневой папке вошедшего пользователя. Возвращаемая коллекция включает любые почтовые папки поиска, находящиеся непосредственно в корне. По умолчанию эта операция не возвращает скрытые папки. Используйте параметр запроса includeHiddenFolders, чтобы включить их в ответ. Эта операция не возвращает все почтовые папки в почтовом ящике, а только дочерние папки корневой папки. Чтобы вернуть все почтовые папки в почтовом ящике, необходимо перебрать каждую дочернюю папку отдельно.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • includeHiddenFoldersstring

    Включать скрытые папки

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-mail-messagesтолько чтениевнешний мир

Перечисляет, ищет и фильтрует сообщения электронной почты Outlook в почтовом ящике текущего пользователя по всем папкам. Возвращает метаданные сообщения (тема, отправитель, дата получения, прочитано, есть вложения), а также предпросмотр тела письма. Используйте $search для запросов по ключевым словам, $filter для фильтрации по отправителю/состоянию прочтения/дате, $top для ограничения размера страницы и $select для сокращения полей. 💡 СОВЕТ: перечисляйте, читайте и ищите мои письма Outlook по всем папкам. КРИТИЧЕСКИ ВАЖНО: при поиске писем значение параметра $search ОБЯЗАТЕЛЬНО должно быть заключено в двойные кавычки. Формат: $search="ваш поисковый запрос". Используйте синтаксис KQL (Keyword Query Language) для поиска по конкретным свойствам: 'from:', 'subject:', 'body:', 'to:', 'cc:', 'bcc:', 'attachment:', 'hasAttachments:', 'importance:', 'received:', 'sent:'. Примеры: $search="from:john@example.com" | $search="subject:meeting AND hasAttachments:true" | $search="body:urgent AND received>=2024-01-01" | $search="from:john AND importance:high". Помните: ВСЕГДА заключайте всё поисковое выражение в двойные кавычки! Ссылка: https://learn.microsoft.com/en-us/graph/search-query-parameter ВАЖНО: всегда используйте $select для ограничения возвращаемых полей и уменьшения размера ответа. Рекомендуемый набор по умолчанию: $select=id,subject,from,toRecipients,receivedDateTime,bodyPreview,isRead,hasAttachments. Для списков используйте bodyPreview вместо body. Чтобы прочитать полное тело письма, используйте get-mail-message с конкретным идентификатором сообщения.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • includeHiddenMessagesstring

    Включает скрытые сообщения.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-mail-rulesтолько чтениевнешний мир

Получает все объекты messageRule, определённые для папки "Входящие" пользователя. 💡 TIP: Перечисляет все правила сообщений для почтовой папки. Используйте идентификатор папки Inbox (получите его из list-mail-folders) для правил входящих сообщений. Каждое правило включает displayName, sequence, isEnabled, conditions (fromAddresses, subjectContains и т.д.), actions (moveToFolder, forwardTo, delete и т.д.) и exceptions.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • mailFolderIdstringобязательный

    Значение для сегмента пути 'mailFolderId'. Передавайте его под именем 'mailFolderId', а не как 'id'. Используйте поле 'id' объекта почтовой папки, возвращаемое Microsoft Graph.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-my-calendar-permissionsтолько чтениевнешний мир

Разрешения пользователей, которым предоставлен доступ к календарю. 💡 Совет: Перечисляет получателей общего доступа и делегатов в основном календаре пользователя. Возвращает объекты calendarPermission с полями id, role ('none' | 'freeBusyRead' | 'limitedRead' | 'read' | 'write' | 'delegateWithoutPrivateEventAccess' | 'delegateWithPrivateEventAccess' | 'custom'), emailAddress { name, address }, isInsideOrganization, isRemovable, allowedRoles. Возвращает пустую коллекцию при вызове делегатом или получателем доступа (только владелец календаря видит полный список). Для неосновного календаря используйте /me/calendars/{calendar-id}/calendarPermissions — в настоящее время не раскрыта.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-onenote-notebooksтолько чтениевнешний мир

Получает список объектов notebook.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-onenote-notebook-sectionsтолько чтениевнешний мир

Извлекает список объектов onenoteSection из указанной записной книжки.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • notebookIdstringобязательный

    Значение для сегмента пути 'notebookId'. Передавайте его под именем 'notebookId', а не как 'id'. Используйте поле 'id' объекта notebook, которое возвращает Microsoft Graph.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-onenote-pagesтолько чтениевнешний мир

Получает список объектов страниц. 💡 СОВЕТ: Перечисляет все страницы OneNote в каждой записной книжке и разделе, к которым у пользователя есть доступ — поперечная альтернатива обходу записных книжек → разделов → страниц. По умолчанию возвращает первые 20, отсортированные по lastModifiedTime по убыванию. Поддерживает $filter (например, lastModifiedTime gt 2026-01-01 или contains(tolower(title), 'topic') для поиска по заголовку), $top (макс. 100), $select и $expand=parentNotebook,parentSection. Используйте этот метод вместо перебора list-onenote-notebooks / list-all-onenote-sections / list-onenote-section-pages, когда у вас есть конкретная тема.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-onenote-section-groupsтолько чтениевнешний мир

Получает список объектов sectionGroup. 💡 СОВЕТ: Выводит все группы разделов OneNote (подпапки внутри блокнотов, содержащие собственные разделы и вложенные группы разделов) для пользователя. Группа разделов - это контейнер, похожий на папку. Многие блокноты используют их для организации разделов по темам. Сортировка по умолчанию - по имени по возрастанию. Поддерживает $expand=sections,sectionGroups,parentNotebook,parentSectionGroup для обхода полной иерархии. Используйте вместе с list-onenote-notebooks для полной картины структуры блокнотов пользователя.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-onenote-section-pagesтолько чтениевнешний мир

Извлекает список объектов страницы из указанного раздела.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • onenoteSectionIdstringобязательный

    Значение для сегмента пути 'onenoteSectionId'. Передавайте его под именем 'onenoteSectionId', а не как 'id'. Используйте поле 'id' объекта раздела OneNote, которое возвращает Microsoft Graph.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-outlook-categoriesтолько чтениевнешний мир

Получает все категории, которые были определены для пользователя. 💡 СОВЕТ: Перечисляет категории Outlook пользователя (цветные метки), используемые для пометки сообщений, событий, контактов и задач. Каждая категория имеет displayName и color (preset0 – preset24 или 'none'). Используйте это, чтобы показать доступные метки перед применением через update-mail-message или update-calendar-event с телом { categories: ['categoryName'] }.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-outlook-contactsтолько чтениевнешний мир

Получает коллекцию контактов из папки контактов по умолчанию вошедшего в систему пользователя. Есть два сценария, в которых приложение может получить контакты из папки контактов другого пользователя: 💡 СОВЕТ: $filter поддерживает только startswith(), а contains() и eq для emailAddresses не работают. Используйте $search как альтернативу для более широкого поиска.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-plan-bucketsтолько чтениевнешний мир

Возвращает список объектов plannerBucket, содержащихся в объекте plannerPlan.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • plannerPlanIdstringобязательный

    Значение для сегмента пути 'plannerPlanId'. Передавайте его под именем 'plannerPlanId', а не 'id'. Используйте поле 'id' объекта planner plan, возвращаемого Microsoft Graph.

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-planner-task-messagesтолько чтениевнешний мир

[beta] Получает список объектов plannerTaskChatMessage, связанных с задачей plannerTask. 💡 СОВЕТ: Выводит список сообщений в чате задачи Planner — современный "чат задачи" Planner, в отличие от устаревших комментариев conversationThreadId (которые находятся в ветке обсуждения группы M365). Каждое сообщение содержит id, content (HTML), createdBy, createdDateTime, mentions, reactions. BETA Graph API: может меняться; только делегированные рабочие/учебные учетные записи — без разрешений приложений, без личных учетных записей Microsoft, только глобальное облако (не GCC/DoD/21Vianet).

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • plannerTaskIdstringобязательный

    Значение для сегмента пути 'plannerTaskId'. Передавайте его под именем 'plannerTaskId', а не 'id'. Используйте поле 'id' объекта planner task, возвращаемое Microsoft Graph.

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-planner-tasksтолько чтениевнешний мир

Получает список объектов plannertask, назначенных пользователю. 💡 СОВЕТ: Приоритет: от 0 до 10 (меньше значение = выше приоритет); собственные пресеты интерфейса Planner: 1=Срочно, 3=Важно, 5=Средне, 9=Низко.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-plan-tasksтолько чтениевнешний мир

Извлекает список объектов plannerTask, связанных с объектом plannerPlan. 💡 СОВЕТ: Приоритет от 0 до 10 (ниже = выше приоритет); собственные пресеты интерфейса Planner: 1=Срочно, 3=Важно, 5=Средне, 9=Низко.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • plannerPlanIdstringобязательный

    Значение для сегмента пути 'plannerPlanId'. Передавайте его под именем 'plannerPlanId', а не 'id'. Используйте поле 'id' объекта planner plan, возвращаемого Microsoft Graph.

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-specific-calendar-eventsтолько чтениевнешний мир

Перечисляет события из одного из календарей вошедшего в систему пользователя, заданного по calendar ID. 💡 ПОДСКАЗКА: ВНИМАНИЕ: НЕ разворачивает повторяющиеся события — возвращает только seriesMaster. Вместо этого используйте get-specific-calendar-view.

Параметры
  • calendarIdstringобязательный

    Значение для сегмента пути 'calendarId'. Передавайте его под именем 'calendarId', а не как 'id'. Используйте поле 'id' объекта календаря, возвращаемого Microsoft Graph.

  • countboolean

    Установите true, чтобы включить расширенный режим запросов (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count, общее количество для отфильтрованной коллекции, которое может превышать количество элементов, возвращаемых, когда fetchAllPages упирается в свой лимит страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • expandExtendedPropertiesboolean

    При значении true разворачивает singleValueExtendedProperties для каждого события. Используйте этот параметр, чтобы получить настраиваемые расширенные свойства (например, метаданные синхронизации), хранящиеся в событиях календаря.

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы остаются теми же.

  • timezonestring

    Название часового пояса IANA (например, «America/New_York», «Europe/London», «Asia/Tokyo») для времени событий календаря. Если не указано, время возвращается в UTC.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-subscriptionsтолько чтениевнешний мир

Получает свойства и связи подписок webhook на основе идентификатора приложения, пользователя и его роли в клиенте. Содержимое ответа зависит от контекста, в котором приложение выполняет вызов; подробности — в сценариях раздела Permissions. 💡 Совет: выводит список подписок webhook, принадлежащих текущему приложению или пользователю. Возвращает id, resource, changeType, notificationUrl, expirationDateTime, clientState. Используйте $filter=resource eq '/me/messages', чтобы найти подписки для конкретного ресурса. Отдельной области действия 'Subscription.*' не существует — вызывающая сторона уже должна иметь разрешение на чтение подписанного ресурса (например, Mail.Read для /me/messages), которое предоставляет инструмент, читающий этот ресурс.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-supported-languagesтолько чтениевнешний мир

Получает список языков и региональных параметров, поддерживаемых для пользователя и настроенных на его почтовом сервере. При настройке клиента Outlook пользователь выбирает предпочитаемый язык из этого списка поддерживаемых. После этого вы можете получить предпочитаемый язык, получив настройки почтового ящика пользователя. 💡 СОВЕТ: Перечисляет языки и региональные параметры, которые почтовый сервер пользователя поддерживает для интерфейса Outlook и отображения сообщений. Возвращает объекты localeInfo с параметром locale (например, 'en-US') и displayName ('English (United States)'). Используйте это для проверки значения locale перед вызовом update-mailbox-settings для изменения предпочитаемого языка пользователя.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-supported-time-zonesтолько чтениевнешний мир

Получает список часовых поясов, поддерживаемых для пользователя, согласно настройкам сервера его почтового ящика. Вы можете явно указать, чтобы часовые пояса возвращались в формате Windows или в формате часовых поясов Internet Assigned Numbers Authority (IANA), также известном как формат часовых поясов Olson. По умолчанию используется формат Windows. При настройке клиента Outlook пользователь выбирает предпочтительный часовой пояс из этого списка поддерживаемых. Затем вы можете получить предпочтительный часовой пояс, запросив настройки почтового ящика пользователя. 💡 СОВЕТ: Перечисляет часовые пояса, которые поддерживает сервер почтового ящика пользователя. Параметр пути TimeZoneStandard должен быть одним из: Windows (по умолчанию: имена часовых поясов Windows, например 'Pacific Standard Time') или Iana (имена IANA/Olson, например 'America/Los_Angeles'). Обратите внимание на PascalCase: значения регистрозависимы, это перечисления, а не строки в нижнем регистре. Возвращает объекты timeZoneInformation с полями alias и displayName. Используйте результат, чтобы проверить или найти значение перед вызовом update-mailbox-settings для изменения предпочтительного timeZone пользователя или перед установкой timeZone для начала/конца события календаря (особенно для повторяющихся событий). Не угадывайте имя часового пояса по памяти, ищите значение здесь.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • TimeZoneStandardstringобязательный

    Значение для сегмента пути 'TimeZoneStandard'.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-todo-checklist-itemsтолько чтениевнешний мир

Получает ресурсы checklistItem, связанные с todoTask, из свойства навигации checklistItems. 💡 СОВЕТ: Перечисляет шаги (элементы контрольного списка) задачи To Do. У каждого элемента есть id, displayName, isChecked, checkedDateTime и createdDateTime. Graph не поддерживает параметры запроса OData на этом эндпоинте, поэтому не передавайте select, filter, orderby или top. Требует todoTaskListId из list-todo-task-lists и todoTaskId из list-todo-tasks.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • todoTaskIdstringобязательный

    Значение для сегмента пути 'todoTaskId'. Передавайте его под именем 'todoTaskId', а не как 'id'. Используйте поле 'id' объекта задачи todo, возвращаемое Microsoft Graph.

  • todoTaskListIdstringобязательный

    Значение для сегмента пути 'todoTaskListId'. Передавайте его под именем 'todoTaskListId', а не как 'id'. Используйте поле 'id' объекта списка задач todo, возвращаемое Microsoft Graph.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-todo-linked-resourcesтолько чтениевнешний мир

Получает информацию об одном или нескольких элементах в партнёрском приложении, на основании которых была создана указанная задача. Информация представлена в объекте linkedResource для каждого элемента. Она включает внешний идентификатор элемента в партнёрском приложении и, если применимо, глубокую ссылку на этот элемент в приложении. 💡 СОВЕТ: Перечисляет ресурсы, связанные с задачей To Do (электронные письма, URL-адреса и т.д.). Каждый связанный ресурс имеет displayName, webUrl, applicationName и deepLink.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • todoTaskIdstringобязательный

    Значение для сегмента пути 'todoTaskId'. Передавайте его под именем 'todoTaskId', а не как 'id'. Используйте поле 'id' объекта задачи todo, возвращаемое Microsoft Graph.

  • todoTaskListIdstringобязательный

    Значение для сегмента пути 'todoTaskListId'. Передавайте его под именем 'todoTaskListId', а не как 'id'. Используйте поле 'id' объекта списка задач todo, возвращаемое Microsoft Graph.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-todo-task-listsтолько чтениевнешний мир

Получает список объектов todoTaskList и их свойства. 💡 СОВЕТ: Перечисляет все списки задач. Возвращает todoTaskList-id, необходимый для всех операций с задачами. Список по умолчанию обычно называется 'Tasks'. ПРИМЕЧАНИЕ: $select НЕ поддерживается этой конечной точкой - не передавайте параметр select, Graph возвращает 400.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

list-todo-tasksтолько чтениевнешний мир

Получает ресурсы todoTask из навигационного свойства tasks указанного todoTaskList. 💡 СОВЕТ: Выводит задачи в списке To Do. Требуется todoTaskList-id - используйте list-todo-task-lists, чтобы найти его. ПРИМЕЧАНИЕ: $select НЕ поддерживается - не передавайте select, Graph возвращает код 400. Используйте $filter=status eq 'notStarted' или $filter=status eq 'completed', чтобы отфильтровать по статусу. Используйте $top для ограничения количества результатов. Возможные значения статуса: 'notStarted', 'inProgress', 'completed', 'waitingOnOthers', 'deferred'.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • todoTaskListIdstringобязательный

    Значение для сегмента пути 'todoTaskListId'. Передавайте его под именем 'todoTaskListId', а не как 'id'. Используйте поле 'id' объекта списка задач todo, возвращаемое Microsoft Graph.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

login

Аутентифицирует с учётной записью Microsoft

Параметры
  • forceboolean

    Принудительно выполнить новый вход, даже если пользователь уже вошел в систему.

logout

Выйти из учетной записи Microsoft

Параметры

Без параметров.

merge-excel-rangeвнешний мир

Объединяет диапазон Excel. 💡 СОВЕТ: Объединяет ячейки в указанном диапазоне в одну ячейку. Body: { across: false } объединяет весь диапазон в одну ячейку; { across: true } объединяет каждую строку отдельно. Пригодится для создания стилизованных заголовков, баннерных строк и макетов отчетов.

Параметры
  • addressstringобязательный

    Значение для сегмента пути 'address'.

  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • workbookWorksheetIdstringобязательный

    Значение для сегмента пути 'workbookWorksheetId'. Передавайте его под именем 'workbookWorksheetId', а не как 'id'. Используйте поле 'id' объекта рабочего листа книги, возвращаемого Microsoft Graph.

move-mail-messageвнешний мир

Перемещает сообщение в другую папку в почтовом ящике указанного пользователя. Это создаёт новую копию сообщения в целевой папке и удаляет исходное сообщение. 💡 СОВЕТ: destinationId принимает идентификатор папки или стандартное имя (inbox, drafts, sentitems, deleteditems, junkemail, archive).

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • messageIdstringобязательный

    Значение для сегмента пути 'messageId'. Передавайте его под именем 'messageId', а не как 'id'. Используйте поле 'id' объекта сообщения, возвращаемое Microsoft Graph.

move-rename-onedrive-itemвнешний мир

Перемещает или переименовывает элемент OneDrive. 💡 СОВЕТ: Перемещает и/или переименовывает файл или папку. Чтобы переместить, укажите parentReference с id целевой папки. Чтобы переименовать, укажите новое имя. Обе операции можно выполнить в одном запросе.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

parse-teams-urlтолько чтение

Преобразует любой формат URL собрания Teams (короткий /meet/, полный /meetup-join/ или recap с ?threadId=) в стандартный joinWebUrl. Используйте этот инструмент перед list-online-meetings, когда пользователь предоставляет recap или короткий URL.

Параметры
  • urlstringобязательный

    URL встречи Teams в любом формате

reauthorize-subscriptionвнешний мир

Переавторизует подписку при получении запроса reauthorizationRequired. 💡 СОВЕТ: Повторно авторизует подписку после получения уведомления жизненного цикла 'reauthorizationRequired' от Microsoft Graph. Тело запроса не требуется. Вызов должен производиться в окне reauthorizationRequiredDateTime (обычно 48 часов), чтобы избежать истечения срока подписки.

Параметры
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • subscriptionIdstringобязательный

    Значение для сегмента пути 'subscriptionId'. Передавайте его под именем 'subscriptionId', а не как 'id'. Используйте поле 'id' объекта подписки, возвращаемое Microsoft Graph.

remove-account

Удаляет учётную запись Microsoft из кеша. Принимает адрес электронной почты (например, user@outlook.com) или идентификатор учётной записи. Используйте list-accounts, чтобы узнать доступные учётные записи.

Параметры
  • accountstringобязательный

    Email-адрес или ID аккаунта, который нужно удалить

reply-all-mail-messageвнешний мир

Отвечает всем получателям сообщения в формате JSON или MIME. При использовании формата JSON: - Укажите либо comment, либо свойство body параметра message. Указание обоих приведет к ошибке HTTP 400 Bad Request. - Если исходное сообщение указывает получателя в свойстве replyTo в соответствии с Internet Message Format (RFC 2822), отправляет ответ получателям из replyTo, а не получателю из свойства from. При использовании формата MIME: - Укажите соответствующие заголовки интернет-сообщения и MIME-содержимое, закодированные в формате base64 в теле запроса. - Добавьте любые вложения и свойства S/MIME в MIME-содержимое. Этот метод сохраняет сообщение в папке Sent Items. Альтернативно, создайте черновик для ответа всем на сообщение и отправьте его позже. 💡 СОВЕТ: Ответ всем с сохранением полного HTML-форматирования. Поле 'comment' — ваш текст.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • messageIdstringобязательный

    Значение для сегмента пути 'messageId'. Передавайте его под именем 'messageId', а не как 'id'. Используйте поле 'id' объекта сообщения, возвращаемое Microsoft Graph.

reply-mail-messageвнешний мир

Отвечает отправителю сообщения в формате JSON или MIME. При использовании формата JSON: * Указывайте либо свойство comment, либо свойство body параметра message. Указание обоих вернёт ошибку HTTP 400 Bad Request. * Если исходное сообщение содержит получателя в свойстве replyTo, в соответствии с Internet Message Format (RFC 2822), отправляйте ответ получателям из replyTo, а не получателю из свойства from. При использовании формата MIME: - Предоставьте соответствующие заголовки Internet Message и содержимое MIME, закодированные в base64, в теле запроса. - Добавьте любые вложения и свойства S/MIME в содержимое MIME. Этот метод сохраняет сообщение в папке Sent Items. Либо создайте черновик для ответа на существующее сообщение и отправьте его позже. 💡 TIP: Отвечайте на письмо с сохранением полного HTML-форматирования. Поле 'comment' содержит текст вашего ответа. НЕ восстанавливайте письмо вручную.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • messageIdstringобязательный

    Значение для сегмента пути 'messageId'. Передавайте его под именем 'messageId', а не как 'id'. Используйте поле 'id' объекта сообщения, возвращаемое Microsoft Graph.

search-onedrive-filesтолько чтениевнешний мир

Ищет элементы в иерархии по заданному запросу. Можно искать в иерархии папок, на всём диске или среди файлов, к которым у текущего пользователя есть доступ. 💡 СОВЕТ: Ищет файлы на диске по имени или содержимому. Параметр q проверяет имена файлов, метаданные и содержимое файлов. Возвращает подходящие объекты driveItem с полями id, name, webUrl, size, lastModifiedDateTime. Сначала используйте list-drives, чтобы получить идентификатор диска.

Параметры
  • countboolean

    Значение true включает расширенный режим запроса (ConsistencyLevel: eventual). Требуется для сложного $filter по flag/flagStatus или contains(). Тогда ответ включает @odata.count - общее количество для отфильтрованной коллекции, которое может превышать число элементов, возвращаемых, когда fetchAllPages достигает лимита страниц/элементов.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • expandstring | string[]

    Навигационные свойства для встраивания, например attachments у сообщения или события. Разворачивать можно только навигационные свойства: попытка развернуть ненавигационное свойство, например тело сообщения, завершается ошибкой "Parsing OData Select and Expand failed". Обычные поля запрашивайте через $select. Некоторые API принимают только одну связь на запрос, поэтому указывайте одно значение. Некоторые связи поддерживают вложенную выборку, например children($select=id,name).

  • fetchAllPagesboolean

    Следуй за @odata.nextLink и объединяй до 100 страниц в один ответ. Может вернуть огромный объём данных - только если пользователю реально нужен полный экспорт. Сначала бери небольшой $top, а потом пагинируй или сужай выборку через $filter/$search.

  • filterstring

    Выражение фильтра OData. Добавьте $count=true для расширенных фильтров (flag/flagStatus, contains()). Нельзя комбинировать с $search.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • orderbystring | string[]

    Выражение сортировки, например receivedDateTime desc

  • qstringобязательный

    Значение для сегмента пути 'q'.

  • searchstring

    Поисковый запрос KQL заключается в одну пару двойных кавычек; для каталога (users/groups) вместо этого каждая часть заключается в кавычки без внешней пары. Нельзя сочетать с $filter.

  • selectstring | string[]

    Поля, разделенные запятыми, для возврата, например: id,subject,from,receivedDateTime

  • skipinteger

    Элементы для пропуска при пагинации. Не поддерживается с $search.

  • skiptokenstring

    Следующая страница: @odata.nextLink из предыдущего ответа. Остальные аргументы оставьте теми же.

  • topinteger

    Размер страницы (параметр $top в Graph). Начните с небольших значений (например, 5–15), чтобы ответы помещались в контекст модели; увеличивайте только при необходимости. Используйте $select, чтобы возвращать меньше полей в каждом элементе. Если нужно больше записей, используйте @odata.nextLink из ответа вместо очень большого значения $top.

select-account

Выбирает учётную запись Microsoft по умолчанию. Принимает адрес электронной почты (например, user@outlook.com) или идентификатор учётной записи. Используйте list-accounts, чтобы найти доступные учётные записи.

Параметры
  • accountstringобязательный

    Электронная почта или ID аккаунта для выбора

send-draft-messageвнешний мир

Отправляет существующий черновик сообщения. Черновик может быть новым черновиком, черновиком ответа, черновиком ответа всем или черновиком пересылки. Этот метод сохраняет сообщение в папке "Отправленные". Альтернативно, отправляет новое сообщение одной операцией. 💡 СОВЕТ: тело запроса не требуется — просто вызовите с идентификатором сообщения. Черновик должен существовать в папке "Черновики".

Параметры
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • messageIdstringобязательный

    Значение для сегмента пути 'messageId'. Передавайте его под именем 'messageId', а не как 'id'. Используйте поле 'id' объекта сообщения, возвращаемое Microsoft Graph.

send-mailвнешний мир

Отправляет сообщение, указанное в теле запроса, в формате JSON или MIME. При использовании формата JSON вы можете включить вложение файла в тот же вызов действия sendMail. При использовании формата MIME: этот метод сохраняет сообщение в папке «Отправленные». Кроме того, можно создать черновик сообщения для отправки позже. Чтобы узнать больше о шагах, выполняемых в бэкенде перед доставкой письма получателям, смотрите здесь. 💡 СОВЕТ: КРИТИЧЕСКИ ВАЖНО: Не пытайтесь угадать адрес электронной почты получателей. Используйте инструмент list-users, чтобы найти адрес электронной почты получателей.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

share-drive-itemвнешний мир

Отправляет приглашение к совместному доступу для driveItem. Приглашение к совместному доступу предоставляет разрешения получателям и, опционально, отправляет им email с уведомлением о том, что элемент был опубликован. 💡 ПОДСКАЗКА: Предоставляет общий доступ к файлу или папке конкретным пользователям. Тело: { recipients: [{ email: 'user@example.com' }], roles: ['read'], sendInvitation: true, message: 'Please review this file.' }. Роли: 'read', 'write', 'owner'. Установите requireSignIn в true, чтобы требовать вход в систему.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

snooze-calendar-event-reminderвнешний мир

Откладывает напоминание о событии в календаре пользователя до нового времени. 💡 СОВЕТ: Откладывает уже сработавшее напоминание о событии. Тело: { NewReminderTime: { dateTime (ISO 8601), timeZone (IANA or Windows, например 'Pacific Standard Time') } }. Напоминание сработает заново в новое время.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • eventIdstringобязательный

    Значение для сегмента пути 'eventId'. Передавайте его под именем 'eventId', а не как 'id'. Используйте поле 'id' объекта события, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

sort-excel-rangeвнешний мир

Сортирует диапазон Excel.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • workbookWorksheetIdstringобязательный

    Значение для сегмента пути 'workbookWorksheetId'. Передавайте его под именем 'workbookWorksheetId', а не как 'id'. Используйте поле 'id' объекта рабочего листа книги, возвращаемого Microsoft Graph.

tentatively-accept-calendar-eventвнешний мир

Предварительно принимает указанное событие в календаре пользователя. Если событие допускает предложения нового времени, при ответе «Предварительно принято» на событие участник может предложить альтернативное время, указав параметр proposedNewTime. Дополнительную информацию о том, как предложить время и как получить и принять новое предложение времени, см. в разделе Propose new meeting times. 💡 СОВЕТ: Предварительно принимает приглашение на встречу. Необязательное тело: { sendResponse: true, comment: 'I might be able to attend.' }. Используйте proposedNewTime, чтобы предложить альтернативу: { proposedNewTime: { start: { dateTime, timeZone }, end: { dateTime, timeZone } } }.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • eventIdstringобязательный

    Значение для сегмента пути 'eventId'. Передавайте его под именем 'eventId', а не как 'id'. Используйте поле 'id' объекта события, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

unmerge-excel-rangeвнешний мир

Отменяет объединение диапазона Excel. 💡 TIP: Отменяет объединение всех объединённых ячеек в указанном диапазоне обратно в отдельные ячейки. Без тела запроса. Обратная операция к merge-excel-range.

Параметры
  • addressstringобязательный

    Значение для сегмента пути 'address'.

  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • workbookWorksheetIdstringобязательный

    Значение для сегмента пути 'workbookWorksheetId'. Передавайте его под именем 'workbookWorksheetId', а не как 'id'. Используйте поле 'id' объекта рабочего листа книги, возвращаемого Microsoft Graph.

update-calendarвнешний мир

Обновляет календарь. 💡 СОВЕТ: Обновляет свойства календаря. Тело: { name: 'New Name', color: 'lightBlue' }. Не обновляет свойства календаря по умолчанию.

Параметры
  • bodyobjectобязательный
  • calendarIdstringобязательный

    Значение для сегмента пути 'calendarId'. Передавайте его под именем 'calendarId', а не как 'id'. Используйте поле 'id' объекта календаря, возвращаемого Microsoft Graph.

  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

update-calendar-eventвнешний мир

Обновляет событие в календаре по умолчанию. Требует eventId (идентификатор события из get-calendar-view или list-calendar-events). Время задаётся вложенными объектами {dateTime, timeZone}. Для разовых событий проще всего использовать UTC; для повторяющихся событий используйте часовой пояс организатора (из get-mailbox-settings или list-supported-time-zones) вместо UTC, поскольку Graph вычисляет переход на летнее время относительно этого пояса. 💡 СОВЕТ: КРИТИЧЕСКИ ВАЖНО: Не пытайтесь угадывать адрес электронной почты получателей. Используйте инструмент list-users, чтобы найти адрес электронной почты получателей. ПРЕДУПРЕЖДЕНИЕ: Указание участников заменяет весь список участников: включайте всех участников, а не только новых.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • eventIdstringобязательный

    Значение для сегмента пути 'eventId'. Передавайте его под именем 'eventId', а не как 'id'. Используйте поле 'id' объекта события, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

update-contact-folderвнешний мир

Обновляет свойства объекта contactfolder. 💡 СОВЕТ: Обновляет контактную папку. Тело: { displayName?: 'New name', parentFolderId?: '<id>' } — оба свойства displayName (переименование) и parentFolderId (перемещение) доступны для записи. Папку 'Contacts' по умолчанию, возможно, нельзя переименовать. Получите идентификатор папки через list-contact-folders.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • contactFolderIdstringобязательный

    Значение для сегмента пути 'contactFolderId'. Передавайте его под именем 'contactFolderId', а не как 'id'. Используйте поле 'id' объекта папки контактов, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

update-excel-rangeвнешний мир

Обновляет диапазон Excel. 💡 СОВЕТ: Задаёт значения ячеек, формулы или числовой формат для любого диапазона — НЕ требует, чтобы лист был формальной таблицей Excel. Body: { values: [['v1','v2','v3']] } для одной строки или [['a','b'],['c','d']] для нескольких строк. Используйте это для добавления (укажите адрес следующей пустой строки, например 'A172:H172'), обновления (укажите отдельную ячейку типа 'H42') или вставки в начало (прочитайте существующие данные, объедините, запишите обратно). Количество значений во внутреннем массиве должно соответствовать количеству столбцов диапазона.

Параметры
  • addressstringобязательный

    Значение для сегмента пути 'address'.

  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • workbookWorksheetIdstringобязательный

    Значение для сегмента пути 'workbookWorksheetId'. Передавайте его под именем 'workbookWorksheetId', а не как 'id'. Используйте поле 'id' объекта рабочего листа книги, возвращаемого Microsoft Graph.

update-excel-table-rowвнешний мир

Обновляет строку таблицы Excel. 💡 СОВЕТ: Обновляет одну строку в формальной таблице Excel по индексу строки, начиная с нуля. Тело: { values: [[...]] } с одним внутренним массивом, соответствующим количеству столбцов.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • indexstringобязательный

    Значение для сегмента пути 'index'.

  • workbookTableIdstringобязательный

    Значение для сегмента пути 'workbookTableId'. Передавайте его под именем 'workbookTableId', а не как 'id'. Используйте поле 'id' объекта таблицы книги, которое возвращает Microsoft Graph.

update-focused-inbox-overrideвнешний мир

Изменяет поле classifyAs переопределения в соответствии с заданными параметрами. Нельзя использовать PATCH для изменения любых других полей в экземпляре inferenceClassificationOverride. Если для отправителя существует переопределение и отправитель меняет свое отображаемое имя, вы можете использовать POST, чтобы принудительно обновить поле имени в существующем переопределении. Если для отправителя существует переопределение и отправитель меняет свой SMTP-адрес, удаление существующего переопределения и создание нового с новым SMTP-адресом — единственный способ «обновить» переопределение для этого отправителя. 💡 СОВЕТ: Обновляет поле classifyAs существующего переопределения. Тело: { classifyAs: 'focused' } или { classifyAs: 'other' }. Согласно Graph API, PATCH не может изменить senderEmailAddress — чтобы изменить SMTP-адрес, удалите и создайте переопределение заново. Чтобы переименовать только отображаемое имя, отправьте POST нового переопределения с тем же SMTP-адресом (оно перезапишет имя).

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • inferenceClassificationOverrideIdstringобязательный

    Значение для сегмента пути 'inferenceClassificationOverrideId'. Передавайте его под именем 'inferenceClassificationOverrideId', а не как 'id'. Используйте поле 'id' объекта переопределения классификации входящих сообщений, которое возвращает Microsoft Graph.

update-mailbox-settingsвнешний мир

Включает, настраивает или отключает одну или несколько следующих настроек как часть mailboxSettings пользователя. При обновлении предпочтительного формата даты или времени для пользователя указывайте его в формате краткой даты или краткого времени соответственно. При обновлении предпочтительного часового пояса пользователя указывайте его в часовом поясе Windows или Internet Assigned Numbers Authority (IANA) (также известном как часовой пояс Олсона). Вы также можете дополнительно настроить часовой пояс, как показано в примере 2 ниже. 💡 TIP: Обновляет настройки почтового ящика. Типичное использование: настройка автоответа (автоматических ответов). Пример тела запроса: { automaticRepliesSetting: { status: 'scheduled', scheduledStartDateTime: { dateTime: '2026-03-28T17:00:00', timeZone: 'Eastern Standard Time' }, scheduledEndDateTime: { dateTime: '2026-04-01T08:00:00', timeZone: 'Eastern Standard Time' }, internalReplyMessage: 'I am OOO.', externalReplyMessage: 'I am out of office.' } }. Значения статуса: disabled, alwaysEnabled, scheduled.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

update-mail-folderвнешний мир

Обновляет свойства объекта mailfolder. 💡 СОВЕТ: Переименовывает почтовую папку, обновляя её displayName. Используйте list-mail-folders, чтобы найти ID папки.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • mailFolderIdstringобязательный

    Значение для сегмента пути 'mailFolderId'. Передавайте его под именем 'mailFolderId', а не как 'id'. Используйте поле 'id' объекта почтовой папки, возвращаемое Microsoft Graph.

update-mail-messageвнешний мир

Обновляет существующее письмо Outlook по его идентификатору (message ID) - например, помечает прочитанным или непрочитанным (isRead), устанавливает флаг (flag), изменяет категории, важность или редактирует тему, тело или получателей черновика.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • messageIdstringобязательный

    Значение для сегмента пути 'messageId'. Передавайте его под именем 'messageId', а не как 'id'. Используйте поле 'id' объекта сообщения, возвращаемое Microsoft Graph.

update-mail-ruleвнешний мир

Изменяет записываемые свойства объекта messageRule и сохраняет изменения. 💡 СОВЕТ: Обновляет существующее правило сообщения. Используйте идентификатор папки Inbox (получить его можно из list-mail-folders) для правил входящих сообщений. Отправляйте только изменяемые свойства. Обычное использование: { isEnabled: false } для отключения правила или обновления условий.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • mailFolderIdstringобязательный

    Значение для сегмента пути 'mailFolderId'. Передавайте его под именем 'mailFolderId', а не как 'id'. Используйте поле 'id' объекта почтовой папки, возвращаемое Microsoft Graph.

  • messageRuleIdstringобязательный

    Значение для сегмента пути 'messageRuleId'. Передавайте его под именем 'messageRuleId', а не как 'id'. Используйте поле 'id' объекта правила сообщения, возвращаемое Microsoft Graph.

update-my-calendar-permissionвнешний мир

Обновляет разрешение моего календаря. 💡 СОВЕТ: Изменяет роль (уровень прав), предоставленную существующему получателю общего доступа или делегату. Тело: { role: 'read' | 'write' | 'delegateWithoutPrivateEventAccess' | 'delegateWithPrivateEventAccess' }. Только свойство role доступно для записи — чтобы изменить email получателя или другие свойства, удалите и создайте заново с помощью delete-my-calendar-permission + create-my-calendar-permission. Получите идентификатор разрешения через list-my-calendar-permissions.

Параметры
  • bodyobjectобязательный
  • calendarPermissionIdstringобязательный

    Значение для сегмента пути 'calendarPermissionId'. Передавайте его под именем 'calendarPermissionId', а не как 'id'. Используйте поле 'id' объекта разрешения календаря, возвращаемого Microsoft Graph.

  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

update-outlook-contactвнешний мир

Обновляет свойства контактного объекта. 💡 СОВЕТ: массив emailAddresses заменяется целиком: включайте все адреса, а не только новые.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • contactIdstringобязательный

    Значение для сегмента пути 'contactId'. Передавайте его под именем 'contactId', а не как 'id'. Используйте поле 'id' объекта контакта, возвращаемого Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

update-planner-bucketвнешний мир

Обновляет свойства объекта plannerbucket. 💡 СОВЕТ: КРИТИЧЕСКИ ВАЖНО: Требует заголовок If-Match с ETag из get-planner-bucket (используйте includeHeaders=true).

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstringобязательный

    Значение ETag.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • plannerBucketIdstringобязательный

    Значение для сегмента пути 'plannerBucketId'. Передавайте его под именем 'plannerBucketId', а не как 'id'. Используйте поле 'id' объекта bucket планировщика, возвращаемого Microsoft Graph.

update-planner-taskвнешний мир

Обновляет свойства объекта plannerTask. 💡 СОВЕТ: КРИТИЧЕСКИ ВАЖНО: Требуется заголовок If-Match со значением @odata.etag задачи, иначе возвращается 412 Precondition Failed. Получите ETag из get-planner-task с параметром includeHeaders=true. Приоритет: 0-10 (меньше значение = выше приоритет); собственные пресеты интерфейса Planner: 1=Urgent (Срочный), 3=Important (Важный), 5=Medium (Средний), 9=Low (Низкий).

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstringобязательный

    Значение ETag.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • plannerTaskIdstringобязательный

    Значение для сегмента пути 'plannerTaskId'. Передавайте его под именем 'plannerTaskId', а не 'id'. Используйте поле 'id' объекта planner task, возвращаемое Microsoft Graph.

update-planner-task-detailsвнешний мир

Обновляет свойства объекта plannerTaskDetails. 💡 СОВЕТ: КРИТИЧЕСКИ ВАЖНО: требуется заголовок If-Match с ETag от get-planner-task-details (используйте includeHeaders=true). Элементы контрольного списка используют GUID-ключи: {"checklist": {"<guid>": {"title": "...", "isChecked": false}}}

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • If-Matchstringобязательный

    Значение ETag.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • plannerTaskIdstringобязательный

    Значение для сегмента пути 'plannerTaskId'. Передавайте его под именем 'plannerTaskId', а не 'id'. Используйте поле 'id' объекта planner task, возвращаемое Microsoft Graph.

update-specific-calendar-eventвнешний мир

Обновляет конкретное событие календаря. Требует calendarId (из list-calendars) и eventId (из list-specific-calendar-events или get-specific-calendar-view для того же календаря). Время задаётся вложенными объектами {dateTime, timeZone}. Для разовых событий проще всего использовать UTC; для повторяющихся событий используйте часовой пояс организатора (из get-mailbox-settings или list-supported-time-zones) вместо UTC, поскольку Graph вычисляет переход на летнее время относительно этого пояса. 💡 СОВЕТ: КРИТИЧЕСКИ ВАЖНО: Не пытайтесь угадать адрес электронной почты получателей. Используйте инструмент list-users, чтобы найти адрес электронной почты получателей. ПРЕДУПРЕЖДЕНИЕ: Указание участников заменяет весь список участников: указывайте всех участников, а не только новых.

Параметры
  • bodyobjectобязательный
  • calendarIdstringобязательный

    Значение для сегмента пути 'calendarId'. Передавайте его под именем 'calendarId', а не как 'id'. Используйте поле 'id' объекта календаря, возвращаемого Microsoft Graph.

  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • eventIdstringобязательный

    Значение для сегмента пути 'eventId'. Передавайте его под именем 'eventId', а не как 'id'. Используйте поле 'id' объекта события, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

update-subscriptionвнешний мир

Продлевает подписку, увеличивая время её истечения. В таблице в разделе Permissions перечислены ресурсы, которые поддерживают подписку на уведомления об изменениях. Подписки истекают через разное время в зависимости от типа ресурса. Чтобы не пропустить уведомления об изменениях, приложение должно продлевать подписки задолго до даты их истечения. Смотрите subscription для получения информации о максимальной продолжительности подписки для каждого типа ресурса. 💡 СОВЕТ: Продлевает подписку webhook, увеличивая срок её действия. Тело: { expirationDateTime (ISO 8601, новый срок истечения) }. Вызывайте до текущего expirationDateTime, чтобы не пропустить уведомления. Максимальное продление зависит от типа ресурса — смотрите документацию Microsoft Graph для получения информации об ограничениях подписки.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • subscriptionIdstringобязательный

    Значение для сегмента пути 'subscriptionId'. Передавайте его под именем 'subscriptionId', а не как 'id'. Используйте поле 'id' объекта подписки, возвращаемое Microsoft Graph.

update-todo-checklist-itemвнешний мир

Обновляет свойства объекта checklistItem. 💡 СОВЕТ: Обновляет шаг (элемент чек-листа) задачи To Do. Используйте этот инструмент, чтобы отметить шаг выполненным (body: { isChecked: true }), снять отметку (isChecked: false) или переименовать его (displayName). Требует checklistItemId из list-todo-checklist-items.

Параметры
  • bodyobjectобязательный
  • checklistItemIdstringобязательный

    Значение для сегмента пути 'checklistItemId'. Передавайте его под именем 'checklistItemId', а не как 'id'. Используйте поле 'id' объекта пункта чек-листа, который возвращает Microsoft Graph.

  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • todoTaskIdstringобязательный

    Значение для сегмента пути 'todoTaskId'. Передавайте его под именем 'todoTaskId', а не как 'id'. Используйте поле 'id' объекта задачи todo, возвращаемое Microsoft Graph.

  • todoTaskListIdstringобязательный

    Значение для сегмента пути 'todoTaskListId'. Передавайте его под именем 'todoTaskListId', а не как 'id'. Используйте поле 'id' объекта списка задач todo, возвращаемое Microsoft Graph.

update-todo-taskвнешний мир

Обновляет свойства объекта todoTask. 💡 СОВЕТ: Обновляет задачу Microsoft To Do. Используйте его, чтобы отметить задачу как выполненную или завершённую (body: { status: "completed" }), открыть её заново (status: "notStarted"), переименовать её (title) или изменить её дату выполнения (dueDateTime), напоминание (reminderDateTime), важность или заметки (body). Требует todoTaskListId из list-todo-task-lists и todoTaskId из list-todo-tasks. Шаги (checklistItems) здесь изменить нельзя: Graph отклоняет checklistItems в PATCH-запросе к задаче с кодом 400. Вместо этого используйте create-todo-checklist-item, update-todo-checklist-item или delete-todo-checklist-item.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • todoTaskIdstringобязательный

    Значение для сегмента пути 'todoTaskId'. Передавайте его под именем 'todoTaskId', а не как 'id'. Используйте поле 'id' объекта задачи todo, возвращаемое Microsoft Graph.

  • todoTaskListIdstringобязательный

    Значение для сегмента пути 'todoTaskListId'. Передавайте его под именем 'todoTaskListId', а не как 'id'. Используйте поле 'id' объекта списка задач todo, возвращаемое Microsoft Graph.

update-todo-task-listвнешний мир

Обновляет свойства объекта todoTaskList. 💡 СОВЕТ: Переименовывает список задач Microsoft To Do. Тело: { displayName: 'New name' }. Только displayName можно изменять. Встроенные списки (Flagged emails, список Tasks по умолчанию) переименовать нельзя – API возвращает ошибку. Получите идентификаторы списков через list-todo-task-lists.

Параметры
  • bodyobjectобязательный
  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

  • todoTaskListIdstringобязательный

    Значение для сегмента пути 'todoTaskListId'. Передавайте его под именем 'todoTaskListId', а не как 'id'. Используйте поле 'id' объекта списка задач todo, возвращаемое Microsoft Graph.

upload-file-contentвнешний мир

Поток содержимого — если элемент является файлом. 💡 СОВЕТ: Тело — это строка в base64 с байтами файла; сервер декодирует её перед PUT. Graph принимает до 250 МБ, но вся строка передаётся как аргумент инструмента, и обрезанная строка декодируется в обрезанный файл без ошибки, поэтому используйте create-upload-session вместо отправки большой строки base64. Для новых файлов используйте формат пути: /items/root:/path/to/file.txt:/content. Перезаписывает существующие файлы без предупреждения.

Параметры
  • bodystringобязательный

    Содержимое файла в кодировке Base64. Сервер декодирует его и отправляет необработанные байты через PUT в Microsoft Graph.

  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • driveIdstringобязательный

    Значение для сегмента пути 'driveId'. Передавайте его под именем 'driveId', а не 'id'. Используйте поле 'id' объекта drive, возвращаемое Microsoft Graph.

  • driveItemIdstringобязательный

    Значение для сегмента пути 'driveItemId'. Передавайте его под именем 'driveItemId', а не как 'id'. Используйте поле 'id' объекта drive item, возвращаемое Microsoft Graph.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

upload-my-profile-photoвнешний мир

Обновляет фото для указанного контакта, группы, команды или пользователя в арендаторе. Размер обновляемого фото ограничен 4 МБ. Для этой операции можно использовать PATCH или PUT. 💡 СОВЕТ: Загружает новое фото профиля для текущего пользователя. Тело запроса — строка в base64, представляющая байты изображения (сервер декодирует перед PUT). Фото должно быть в формате JPEG, максимум 4 МБ; base64 передаётся как аргумент инструмента, и усечённая строка записывается без ошибки, поэтому изменяйте размер перед кодированием вместо генерации длинной строки. Microsoft 365 автоматически создаёт уменьшенные HD-варианты (48x48, 64x64, 96x96, 120x120, 240x240, 360x360, 432x432, 504x504, 648x648). Для учётных записей организаций или учебных заведений более точным альтернативным разрешением является ProfilePhoto.ReadWrite.All. Используйте download-bytes с параметром target=/me/photo/$value для получения текущего фото.

Параметры
  • bodystringобязательный

    Содержимое файла в кодировке Base64. Сервер декодирует его и отправляет необработанные байты через PUT в Microsoft Graph.

  • confirmboolean

    Для деструктивных операций при включенном шлюзе подтверждения (MS365_MCP_REQUIRE_CONFIRM=true; по умолчанию выключен). Устанавливается в true только после того, как пользователь явно одобрил это действие. Когда шлюз включен, вызовы без confirm: true возвращают { error: "confirmation_required" } и не затрагивают пользовательские данные.

  • excludeResponseboolean

    Исключите полное тело ответа и возвращайте только индикатор успеха или неудачи.

  • includeHeadersboolean

    Включите заголовки ответа (включая ETag) в метаданные ответа.

verify-login

Проверяет текущий статус аутентификации Microsoft

Параметры

Без параметров.

0.170.2основная
0.170.1
0.170.0
0.169.3
0.169.2
0.169.1
0.169.0
0.168.0
0.167.0
0.166.1
0.166.0
0.165.0
0.164.0
0.163.0
0.162.0
0.161.4
0.161.3
0.161.2
0.161.1
0.161.0
0.160.0
0.159.1
0.159.0
0.158.2
0.158.1
0.158.0
0.157.2
0.157.1
0.157.0
0.156.2
0.156.1
0.156.0
0.155.0
0.154.3
0.154.2
0.154.1
0.154.0
0.153.1
0.153.0
0.152.0
0.151.0
0.150.3
0.150.2
0.150.1
0.150.0
0.149.1
0.149.0
0.148.2
0.148.1
0.148.0
0.147.0
0.146.2
0.146.1
0.146.0
0.145.2
0.145.1
0.145.0
0.144.0
0.143.0
0.142.0
0.141.0
0.140.0
0.139.2
0.139.1
0.139.0
0.138.0
0.137.0
0.136.0
0.135.0
0.134.5
0.134.4
0.134.3
0.134.2
0.134.1
0.134.0
0.133.2
0.133.1
0.133.0
0.132.1
0.132.0
0.131.3
0.131.2
0.131.1
0.131.0
0.130.0
0.129.1
0.129.0
0.128.2
0.128.1
0.128.0
0.127.0
0.126.0
0.125.1
0.125.0
0.124.1
0.124.0
0.123.0
0.122.0
0.121.0
0.120.1
0.120.0
0.119.0
0.118.2
0.118.1
0.118.0
0.117.0
0.116.1
0.116.0
0.115.0
0.114.6
0.114.5
0.114.4
0.114.3
0.114.2
0.114.1
0.114.0
0.113.0
0.112.2
0.112.1
0.111.0
0.110.0
0.109.0
0.108.0
0.107.2
0.107.1
0.107.0
0.106.2
0.106.1
0.106.0
0.105.0
0.104.0
0.103.0
0.102.0
0.101.0
0.100.0
0.99.1
0.99.0
0.98.0
0.97.0
0.96.0
0.95.0
0.94.0
0.93.0
0.92.0
0.91.0
0.90.0
0.89.0
0.88.2
0.88.1
0.88.0
0.87.1
0.87.0
0.86.0
0.85.2
0.85.1
0.85.0
0.84.0
0.83.0
0.82.0
0.81.0
0.80.0
0.79.6
0.79.5
0.79.4
0.79.3
0.79.2
0.79.1
0.79.0
0.78.0
0.77.0
0.76.0
0.75.0
0.74.0
0.73.1
0.73.0
0.72.0
0.71.0
0.70.0
0.69.0
0.68.0
0.67.0
0.66.0
0.65.0
0.64.0
0.63.2
0.63.1
0.63.0
0.62.0
0.61.0
0.60.0
0.59.0
0.58.0
0.57.0
0.56.0
0.55.0
0.54.1
0.54.0
0.53.4
0.53.3
0.53.2
0.53.1
0.53.0
0.52.0
0.51.0
0.50.0
0.49.0
0.48.1
0.48.0
0.47.4
0.47.3
0.47.2
0.47.1
0.47.0
0.46.2
0.46.1
0.46.0
0.45.2
0.45.1
0.45.0
0.44.1
0.44.0
0.43.3
0.43.2
0.43.1
0.43.0
0.42.0
0.41.0
0.40.1
0.40.0
0.39.0
0.38.0
0.37.0
0.36.1
0.36.0
0.35.0
0.34.0
0.33.0
0.32.0
0.31.2
0.31.1
0.31.0
0.30.1
0.30.0
0.29.0
0.28.3
0.28.2
0.28.1
0.28.0
0.27.1
0.27.0
0.26.0
0.25.0
0.24.6
0.24.5
0.24.4
0.24.3
0.24.2
0.24.1
0.24.0
0.23.0
0.22.1
0.22.0
0.21.1
0.21.0
0.20.3
0.20.2
0.20.1
0.20.0
0.19.2
0.19.1
0.19.0
0.18.0
0.17.0
0.16.0
0.15.0
0.14.0
0.13.4
0.13.3
0.13.2
0.13.1
0.13.0
0.12.3
0.12.2
0.12.1
0.12.0
0.11.5
0.11.4
0.11.3
0.11.2
0.11.1
0.11.0
0.10.1
0.10.0
0.9.13
0.9.12
0.9.11
0.9.9
0.9.8
0.9.7
0.9.6
0.9.5
0.9.4
0.9.3
0.9.2
0.9.1
0.9.0
0.8.0
0.7.0
0.6.2
0.6.1
0.6.0
0.5.1
0.5.0
0.4.10
0.4.9
0.4.8
0.4.7
0.4.6
0.4.5
0.4.4
0.4.3
0.4.2
0.4.1
0.4.0
0.3.5
0.3.4
0.3.3
0.3.2
0.3.1
0.3.0
0.2.2
0.2.0
0.1.11
0.1.10
0.1.9

Выберите клиент, чтобы установить softeria/ms-365-mcp-server:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "softeria-ms-365-mcp-server-oyiaqrkqmd": {
      "command": "npx",
      "args": [
        "-y",
        "@softeria/ms-365-mcp-server",
        "--toon"
      ]
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "softeria-ms-365-mcp-server-oyiaqrkqmd": {
      "command": "npx",
      "args": [
        "-y",
        "@softeria/ms-365-mcp-server",
        "--toon"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "softeria-ms-365-mcp-server-oyiaqrkqmd": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@softeria/ms-365-mcp-server",
        "--toon"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"softeria-ms-365-mcp-server-oyiaqrkqmd\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@softeria/ms-365-mcp-server\",\"--toon\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "softeria-ms-365-mcp-server-oyiaqrkqmd": {
      "command": "npx",
      "args": [
        "-y",
        "@softeria/ms-365-mcp-server",
        "--toon"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add softeria-ms-365-mcp-server-oyiaqrkqmd -- npx -y @softeria/ms-365-mcp-server --toon

Либо через JSON-конфиг:

claude mcp add-json softeria-ms-365-mcp-server-oyiaqrkqmd "{\"command\":\"npx\",\"args\":[\"-y\",\"@softeria/ms-365-mcp-server\",\"--toon\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add softeria-ms-365-mcp-server-oyiaqrkqmd -- npx -y @softeria/ms-365-mcp-server --toon

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.softeria-ms-365-mcp-server-oyiaqrkqmd]
command = "npx"
args = ["-y", "@softeria/ms-365-mcp-server", "--toon"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите softeria/ms-365-mcp-server, а в поле команды запуска — строку ниже:
npx -y @softeria/ms-365-mcp-server --toon

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "softeria-ms-365-mcp-server-oyiaqrkqmd": {
      "command": "npx",
      "args": [
        "-y",
        "@softeria/ms-365-mcp-server",
        "--toon"
      ]
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "softeria-ms-365-mcp-server-oyiaqrkqmd": {
      "command": "npx",
      "args": [
        "-y",
        "@softeria/ms-365-mcp-server",
        "--toon"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например softeria-ms-365-mcp-server-oyiaqrkqmd.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: softeria-ms-365-mcp-server-oyiaqrkqmd
    command: npx
    args:
      - "-y"
      - "@softeria/ms-365-mcp-server"
      - "--toon"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "softeria-ms-365-mcp-server-oyiaqrkqmd": {
      "command": "npx",
      "args": [
        "-y",
        "@softeria/ms-365-mcp-server",
        "--toon"
      ]
    }
  }
}

Похожие MCP-сервера

MAG-Cie/mcp-microsoft-todo

MAG-Cie/mcp-microsoft-todo

от mag-cie

MCP-сервер для Microsoft To Do с любыми аккаунтами Microsoft, без настройки Azure, вход через device code. 28 инструментов для управления задачами: создание, поиск, групповые операции, экспорт в iC...

TypeScript⭐ 17
freema/mcp-gsheets

freema/mcp-gsheets

от freema

Полноценный MCP-сервер для интеграции с Google Sheets. Читает, пишет, форматирует ячейки, управляет листами и создаёт диаграммы. Удобен для автоматизации табличных данных через ИИ-ассистентов.

TypeScript⭐ 104
jen6/ticktick-mcp

jen6/ticktick-mcp

от jen6

MCP-сервер для интеграции TickTick с AI-ассистентами. Управляйте задачами с фильтрацией по приоритету, тегам и датам. Создавайте, обновляйте и завершайте задачи. Полезен для автоматизации работы че...

Python⭐ 67
orellazi/coda-mcp

orellazi/coda-mcp

от orellazri

MCP сервер для работы с API Coda: управляйте страницами (создание, чтение, обновление, дублирование, переименование) и таблицами (строки, столбцы, вставка, обновление, удаление, кнопки). Инструмент полезен для интеграции AI-ассистентов с документами Coda и автоматизации рутинных операций.

TypeScript⭐ 62
Miro MCP

Miro MCP

официальный

Официальный MCP-сервер Miro: даёт AI-ассистенту доступ к вашим доскам — читать их содержимое и создавать на них диаграммы, стикеры и документы.

squidcode/timebook-cli

squidcode/timebook-cli

от squidcode

MCP-сервер для Timebook — трекинг времени и управление таймерами. Интегрируется с AI-агентами (Claude, Codex, Cursor) через CLI или удаленный HTTP с OAuth. Позволяет запускать/останавливать таймеры...

TypeScript⭐ 2
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин