帖子资源类型
命名空间: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"}
}