Тип ресурса attachment

  • Статья

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

Важно!

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

Предостережение

Существующие приложения, использующие эту функцию с задачами Outlook, следует обновить, так как задачи Outlook устарели. Дополнительные сведения см. в статье Api To Do в общедоступной предварительной версии .

Вы можете добавить связанное содержимое в событие пользователя, сообщение, задачу Outlook или групповую запись в виде вложения.

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

Задачи Outlook не поддерживают ссылочные вложения.

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

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

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

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

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

Методы

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

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

Свойства

Ниже перечислены базовые свойства любого ресурса 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
}