Тип ресурса attachment

Статья
03/26/2023

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

Вы можете добавить связанное содержимое в экземпляр event, message или post в форме вложения.

События в календарях группы не поддерживают вложения.

attachment — базовый ресурс для следующих производных типов вложений:

файл (ресурс fileAttachment);
элемент (контакт, событие или сообщение, представленные ресурсом itemAttachment);
ссылка на файл (ресурс referenceAttachment).

Примечание. Если вы присоединяете файл к записи группы или присоединяете элемент к событию, сообщению или групповой записи, ограничьте размер вложения до 3 МБ.

Если вы присоединяете файл размером до 3 МБ, его можно добавить в событие пользователя, сообщение или групповую запись.

Если вы присоединяете файл от 3 МБ до 150 МБ к событию или сообщению, можно создать сеанс отправки и итеративно передать диапазоны файла, чтобы вложить его. Пример см. в статье Вложение больших файлов в сообщения Outlook .

Методы

Указанные ниже методы применяются к любому из производных типов вложений (fileAttachment, itemAttachment или referenceAttachment).

Метод	Возвращаемый тип	Описание
Получение вложения	attachment	Чтение свойств, связей или необработанного содержимого объекта, представляющего вложение, которое было добавлено к пользовательскому событию, сообщению или записи.
Добавление вложения в пользовательское событие	attachment	Добавление файла, элемента или вложения-ссылки в качестве события в пользовательском календаре. Эта операция ограничивает размер вложения, в который можно добавить, до 3 МБ.
Добавление вложения в сообщение	attachment	Добавление в сообщение файла, элемента или ссылки в качестве вложения. Эта операция ограничивает размер вложения, в который можно добавить, до 3 МБ.
Создание сеанса для присоединения большого файла	uploadSession	Создайте сеанс отправки, который позволяет приложению итеративно передавать диапазоны файла, чтобы вложить файл в указанное сообщение или событие. Размер файла должен быть от 3 ДО 150 МБ.
Добавление вложения в запись	attachment	Добавление в запись файла, элемента или ссылки в качестве вложения. Эта операция ограничивает размер вложения, в который можно добавить, до 3 МБ.
Список вложений пользовательского события	Коллекция attachment	Получение списка вложений для события в пользовательском календаре.
Список вложений для сообщения	Коллекция attachment	Получение списка вложений для сообщения.
Список вложений для записи	Коллекция attachment	Получение списка вложений для записи.
Удаление	Нет	Удаление объекта, представляющего вложение, которое было добавлено к сообщению, записи или данным о событии.

Свойства

Ниже перечислены базовые свойства любого ресурса attachment. Чтобы просмотреть дополнительные свойства, откройте статью о конкретном типе вложения (fileAttachment, itemAttachment или referenceAttachment).

Свойство	Тип	Описание
contentType	String	Тип MIME.
id	String	Только для чтения.
isInline	Boolean	Значение `true`, если вложение является встроенным. В противном случае — значение `false`.
lastModifiedDateTime	DateTimeOffset	Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, значение полуночи 1 января 2014 г. в формате UTC: `2014-01-01T00:00:00Z`.
name	String	Имя вложенного файла.
size	Int32	Размер вложения в байтах.

Отношения

Нет

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "contentType": "string",
  "id": "string (identifier)",
  "isInline": true,
  "lastModifiedDateTime": "String (timestamp)",
  "name": "string",
  "size": 1024
}