帖子资源类型
命名空间:microsoft.graph
重要
Microsoft Graph /beta
版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
表示 conversationThread 实体中的单个帖子项。
即使无法显式创建帖子,也可以执行以下任一操作来创建帖子:
通过该资源可以使用扩展将自己的数据添加到自定义属性。
方法
方法 | 返回类型 | 说明 |
---|---|---|
列出帖子 | 帖子 | 获取指定线程的帖子。 |
获取帖子 | 帖子 | 获取指定的线程中帖子的属性和关系。 |
回复帖子 | 无 | 在组对话中答复帖子,并向指定线程中添加新帖子。 |
转发帖子 | 无 | 将帖子转发给收件人。 |
Attachments | ||
列出附件 | attachment 集合 | 获取帖子的所有附件。 |
Add attachment | attachment | 将附件添加到帖子中。 |
开放扩展 | ||
创建开放扩展 | openTypeExtension | 创建开放扩展,并将自定义属性添加到新资源或现有资源。 |
获取开放扩展 | openTypeExtension 集合 | 获取扩展名称标识的开放扩展。 |
扩展属性 | ||
创建单值属性 | 帖子 | 在新建或现有帖子中创建一个或多个单值扩展属性。 |
获取单值属性 | 帖子 | 通过使用 $expand or $filter 获取包含单值扩展属性的帖子。 |
创建多值属性 | 帖子 | 在新建或现有的帖子中创建一个或多个多值扩展属性。 |
获取多值属性 | 帖子 | 使用 $expand 获取包含一个多值扩展属性的帖子。 |
属性
属性 | 类型 | 说明 |
---|---|---|
body | itemBody | 帖子的内容。 这是默认属性。 此属性可为 NULL。 |
类别 | String collection | 与帖子关联的类别。 每个类别对应于已为用户定义的 outlookCategory 的 displayName 属性。 |
changeKey | String | 标识帖子的版本。 每次帖子更改时,ChangeKey 也将更改。 这样,Exchange 可以将更改应用于该对象的正确版本。 |
conversationId | String | 对话的唯一 ID。 只读。 |
conversationThreadId | String | 对话线程的唯一 ID。 只读。 |
createdDateTime | DateTimeOffset | 创建帖子时指定。 DateTimeOffset 表示使用 ISO 8601 格式的日期和时间信息,并且始终处于 UTC 时间。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z |
发件人 | recipient | 在委派访问方案中使用。 指示代表另一用户发布了此邮件的帐户。 这是默认属性。 |
hasAttachments | Boolean | 指示帖子是否具有至少一个附件。 这是默认属性。 |
id | String | 只读。 |
importance | importance | 组帖子的重要性: low 、 normal 、 high 。 |
lastModifiedDateTime | DateTimeOffset | 帖子上次修改时指定。 DateTimeOffset 表示使用 ISO 8601 格式的日期和时间信息,并且始终处于 UTC 时间。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z |
newParticipants | recipient collection | 添加到此线程作为帖子一部分的对话参与者。 |
receivedDateTime | DateTimeOffset | 接收到帖子时指定。 DateTimeOffset 表示使用 ISO 8601 格式的日期和时间信息,并且始终处于 UTC 时间。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z |
sender | recipient | 包含发件人的地址。 如果未指定 Sender,则假定 Sender 的值是经过身份验证的用户的地址。 这是默认属性。 |
关系
关系 | 类型 | 说明 |
---|---|---|
attachments | Attachment 集合 | 帖子的 fileAttachment、 itemAttachment 和 referenceAttachment 附件的集合。 此为只读属性。 可为 NULL。 支持 $expand 。 |
extensions | 扩展集合 | 为帖子定义的开放扩展集合。 只读。 可为 NULL。 支持 $expand 。 |
inReplyTo | 文章 | 在 conversationThread 中回复此帖子的早期帖子。 只读。 支持 $expand 。 |
multiValueExtendedProperties | multiValueLegacyExtendedProperty 集合 | 为帖子定义的多值扩展属性的集合。 只读。 可为 Null。 |
singleValueExtendedProperties | singleValueLegacyExtendedProperty collection | 为帖子定义的单值扩展属性的集合。 只读。 可为 Null。 |
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"body": {"@odata.type": "microsoft.graph.itemBody"},
"categories": ["string"],
"changeKey": "string",
"conversationId": "string",
"conversationThreadId": "string",
"createdDateTime": "String (timestamp)",
"from": {"@odata.type": "microsoft.graph.recipient"},
"hasAttachments": true,
"id": "string (identifier)",
"importance": "string",
"lastModifiedDateTime": "String (timestamp)",
"newParticipants": [{"@odata.type": "microsoft.graph.recipient"}],
"receivedDateTime": "String (timestamp)",
"sender": {"@odata.type": "microsoft.graph.recipient"}
}