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

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

Создайте объект fileAttachment , который добавляет в заметку вложенное изображение. Поддерживаются только типы файлов изображений (изображение/png, изображение/jpeg, изображение/gif, изображение/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. Обязательно.

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

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

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

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

Отклик

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

Примеры

Запрос

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

POST https://graph.microsoft.com/v1.0/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"
}