帖子资源类型

命名空间: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"}
}