帖子资源类型

命名空间:microsoft.graph 表示 conversationThread 实体中的单个 Post 项。

即使无法显式创建帖子,也可以执行以下任一操作来创建帖子:

通过该资源可以使用扩展将自己的数据添加到自定义属性。

方法

方法 返回类型 说明
列出帖子 帖子 获取指定线程的帖子。
获取帖子 帖子 获取指定的线程中帖子的属性和关系。
回复帖子 在组对话中答复帖子,并向指定线程中添加新帖子。
转发帖子 将帖子转发给收件人。
Attachments
列出附件 attachment 集合 获取帖子的所有附件。
Add attachment attachment 将附件添加到帖子中。
开放扩展
创建开放扩展 openTypeExtension 创建开放扩展,并在新建或现有的资源实例中添加自定义属性。
获取开放扩展 openTypeExtension 集合 获取通过名称或完全限定的名称识别的一个或多个开放扩展对象。
扩展属性
创建单值属性 帖子 在新建或现有帖子中创建一个或多个单值扩展属性。
获取单值属性 帖子 通过使用 $expand or $filter 获取包含单值扩展属性的帖子。
创建多值属性 帖子 在新建或现有的帖子中创建一个或多个多值扩展属性。
获取多值属性 帖子 使用 $expand 获取包含一个多值扩展属性的帖子。

属性

属性 类型 说明
body itemBody 帖子的内容。 这是默认属性。 此属性可为 NULL。
类别 String collection 与帖子关联的类别。
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 只读。
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 附件 集合 只读。 可为 NULL。 支持 $expand
extensions 扩展集合 为帖子定义的开放扩展集合。 只读。 可为 NULL。 支持 $expand
inReplyTo 帖子 只读。 支持 $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)",
  "lastModifiedDateTime": "String (timestamp)",
  "newParticipants": [{"@odata.type": "microsoft.graph.recipient"}],
  "receivedDateTime": "String (timestamp)",
  "sender": {"@odata.type": "microsoft.graph.recipient"}
}