Создание вложения

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Создайте объект fileAttachment , который добавляет встроенное вложение изображения в заметку. Поддерживаются только типы файлов изображений (image/png, image/jpeg, image/gif или image/bmp) с максимальным размером 3 МБ на вложение. Используйте свойство contentId для ссылки на вложение в тексте HTML заметки с помощью <img src="cid:{contentId}" />.

Разрешения

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

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) ShortNotes.ReadWrite Недоступно.
Делегированные (личная учетная запись Майкрософт) ShortNotes.ReadWrite Недоступно.
Для приложений Не поддерживается. Не поддерживается.

HTTP-запрос

POST /me/notes/{note-id}/attachments
POST /users/{id | userPrincipalName}/notes/{note-id}/attachments

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json. Обязательно.

Текст запроса

В тексте запроса укажите представление объекта fileAttachment в формате JSON.

При создании вложения можно указать следующие свойства.

Свойство Тип Описание
@odata.type String Тип OData ресурса вложения. Обязательно. Установите значение #microsoft.graph.fileAttachment.
name String Имя вложенного файла. Обязательно.
contentType String Тип MIME вложения. Должен быть тип изображения: image/png, image/jpeg, image/gifили image/bmp. Обязательно.
contentBytes String Содержимое файла в кодировке base64. Обязательно.
contentId String Идентификатор, используемый для ссылки на вложение в тексте HTML через cid:. Обязательно.
isInline Boolean Указывает, является ли вложение встроенным вложением. Для вложений заметок должно быть задано значение true . Обязательно.

Отклик

В случае успеха этот метод возвращает код ответа 201 Created и объект attachment в тексте ответа.

Примеры

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/beta/me/notes/AAMkAGI2THVSAAA=/attachments
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.fileAttachment",
  "name": "screenshot.png",
  "contentType": "image/png",
  "contentBytes": "iVBORw0KGgoAAAANSUhEUgAAAAUA...",
  "contentId": "screenshot-001",
  "isInline": true
}

Отклик

Ниже показан пример отклика.

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

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.fileAttachment",
  "id": "AAMkAGI2attach2",
  "name": "screenshot.png",
  "contentType": "image/png",
  "size": 12456,
  "isInline": true,
  "contentId": "screenshot-001",
  "lastModifiedDateTime": "2024-01-29T11:30:00Z"
}
  • Last updated on