attachment 资源类型
命名空间:microsoft.graph
重要
Microsoft Graph /beta
版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
警告
应更新将此功能与 Outlook 任务配合使用的现有应用,因为 Outlook 任务正在弃用。 有关详细信息 ,请参阅公共预览版中的 To Do API 。
您可以以附件的形式向用户 事件、 邮件、 Outlook 任务或组 帖子 添加相关内容。
组日历中的事件不支持附件。
Outlook 任务不支持引用附件。
附件是以下附件派生类型的基础资源:
- 文件(fileAttachment 资源)
- 项(由 itemAttachment 资源表示的联系人、事件或邮件)
- 文件链接(referenceAttachment 资源)
注意:如果要将文件附加到组帖子,或者将项目附加到事件、邮件或组帖子,请将附件的大小限制为 3 MB。
如果附加的文件低于 3 MB,则可以 将文件附件添加到用户事件、 邮件或 组帖子。
如果要将 3 MB 到 150 MB 之间的文件附加到事件或消息,则可以 创建上传会话 ,并迭代上传文件的范围以附加该文件。 有关示例,请参阅 将大型文件附加到 Outlook 邮件 。
方法
以下方法适用于所有附件派生类型(fileAttachment、itemAttachment 或 referenceAttachment)。
方法 | 返回类型 | 说明 |
---|---|---|
获取附件 | attachment | 读取附加到用户事件、邮件、Outlook 任务或帖子的附件的属性、关系或原始内容。 |
将附件添加到用户事件中 | 附件 | 将文件、项目或链接附件添加到用户日历中的事件中。 此操作限制可添加到 3 MB 以下的附件的大小。 |
将附件添加到邮件中 | 附件 | 将文件、项目或将附件链接添加到邮件中。 此操作限制可添加到 3 MB 以下的附件的大小。 |
创建用于附加大型文件的会话 | uploadSession | 创建允许应用以迭代方式上传文件范围的上传会话,以便将文件附加到指定的 消息 或 事件。 文件大小必须介于 3 MB 到 150 MB 之间。 |
将附件添加到 Outlook 任务 (已弃用) | attachment | 将文件或项目附件添加到 Outlook 任务。 |
将附件添加到帖子中 | 附件 | 将文件、项目或链接附件添加到组帖子。 此操作限制可添加到 3 MB 以下的附件的大小。 |
列出用户事件的附件 | 附件集合 | 获取用户日历中事件的附件列表。 |
列出邮件的附件 | 附件 集合 | 获取邮件的附件列表。 |
列出 Outlook 任务的附件 (已弃用) | 附件集合 | 获取 Outlook 任务的附件列表。 |
列出帖子的附件 | 附件 集合 | 获取帖子的附件列表。 |
删除 | 无 | 删除事件、邮件、Outlook 任务或帖子上的附件。 |
属性
下面介绍了任意 attachment 资源的基础属性。 有关其他属性,请参阅具体附件类型(fileAttachment、itemAttachment 或 referenceAttachment)。
属性 | 类型 | 说明 |
---|---|---|
contentType | String | MIME 类型。 |
id | String | 只读。 |
isInline | Boolean | 如果附件是内嵌附件,则为 true ;否则为 false 。 |
lastModifiedDateTime | DateTimeOffset | 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2014 年 1 月 1 日午夜 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
}
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈