Тип ресурса attachment
Пространство имен: microsoft.graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Базовый тип для нескольких типов вложений в записи пользователя, сообщения, задачи или группы, который служит базовым ресурсом для следующих производных типов вложений:
- файл (ресурс fileAttachment);
- Элемент (контакт, событие или сообщение, представленные ресурсом itemAttachment )
- ссылка на файл (ресурс referenceAttachment).
Вы можете добавить связанное содержимое в событие пользователя, сообщение, задачу Outlook или групповую запись в виде вложения.
Предостережение
Задачи Outlook устарели и не возвращают данные 10 августа 2022 г. Обновите существующие приложения, использующие эту функцию, с задачами Outlook.
События в календарях группы не поддерживают вложения.
Задачи Outlook не поддерживают ссылочные вложения.
Примечание. Если вы присоединяете файл к записи группы или присоединяете элемент к событию, сообщению или групповой записи, ограничьте размер вложения до 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
}