帖子资源类型post resource type

表示 conversationThread 实体中的各个帖子项。Represents an individual Post item within a conversationThread entity.

即使无法显式创建帖子,也可以执行以下任一操作来创建帖子:Even though you cannot explicitly create a post, doing any of the following would create a post:

使用此资源,可以使用扩展将自己的数据添加到自定义属性。This resource lets you add your own data to custom properties using extensions.

方法Methods

方法Method 返回类型Return Type 说明Description
列出帖子List posts 帖子post 获取指定线程的帖子。Get the posts of the specified thread.
获取帖子Get post 帖子post 获取指定的线程中帖子的属性和关系。Get the properties and relationships of a post in a specified thread.
答复Reply None 在组对话中答复帖子,并向指定线程中添加新帖子。Reply to a post and add a new post to the specified thread in a group conversation.
转发Forward None 将帖子转发给收件人。Forward a post to a recipient.
附件Attachments
列出附件List attachments attachment 集合attachment collection 获取帖子的所有附件。Get all attachments on a post.
Add attachmentAdd attachment attachmentattachment 将附件添加到帖子中。Add an attachment to a post.
开放扩展Open extensions
创建开放扩展Create open extension openTypeExtensionopenTypeExtension 创建开放扩展,并在新建或现有的资源实例中添加自定义属性。Create an open extension and add custom properties in a new or existing instance of a resource.
获取开放扩展Get open extension openTypeExtension 集合openTypeExtension collection 获取通过名称或完全限定的名称识别的一个或多个开放扩展对象。Get an open extension object or objects identified by name or fully qualified name.
架构扩展Schema extensions
添加架构扩展值Add schema extension values 创建架构扩展定义,然后使用它向资源添加自定义键入数据。Create a schema extension definition and then use it to add custom typed data to a resource.
扩展属性Extended properties
创建单值扩展属性Create single-value extended property 帖子post 在新建或现有帖子中创建一个或多个单值扩展属性。Create one or more single-value extended properties in a new or existing post.
获取具有单值扩展属性的帖子Get post with single-value extended property 帖子post 通过使用 $expand or $filter 获取包含单值扩展属性的帖子。Get posts that contain a single-value extended property by using $expand or $filter.
创建多值扩展属性Create multi-value extended property 帖子post 在新建或现有的帖子中创建一个或多个多值扩展属性。Create one or more multi-value extended properties in a new or existing post.
获取具有多值扩展属性的帖子Get post with multi-value extended property 帖子post 使用 $expand 获取包含一个多值扩展属性的帖子。Get a post that contains a multi-value extended property by using $expand.

属性Properties

属性Property 类型Type 说明Description
bodybody itemBodyitemBody 帖子的内容。这是默认属性。此属性可为 NULL。The contents of the post. This is a default property. This property can be null.
categoriescategories String collectionString collection 与帖子关联的类别。The categories associated with the post.
changeKeychangeKey StringString 标识帖子的版本。每次帖子更改时,ChangeKey 也将更改。这样,Exchange 可以将更改应用于该对象的正确版本。Identifies the version of the post. Every time the post is changed, ChangeKey changes as well. This allows Exchange to apply changes to the correct version of the object.
conversationIdconversationId StringString 对话的唯一 ID。只读。Unique ID of the conversation. Read-only.
conversationThreadIdconversationThreadId 字符串String 对话线程的唯一 ID。只读。Unique ID of the conversation thread. Read-only.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset 创建帖子时指定。DateTimeOffset 表示使用 ISO 8601 格式的日期和时间信息,并且始终处于 UTC 时间。例如,2014 年 1 月 1 日午夜 UTC 类似于如下形式:'2014-01-01T00:00:00Z'Specifies when the post was created. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
发件人from recipientrecipient 在委派访问方案中使用。指示代表另一用户发布了此邮件的帐户。这是默认属性。Used in delegate access scenarios. Indicates who posted the message on behalf of another user. This is a default property.
hasAttachmentshasAttachments BooleanBoolean 指示帖子是否具有至少一个附件。这是默认属性。Indicates whether the post has at least one attachment. This is a default property.
idid StringString 只读。Read-only.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset 帖子上次修改时指定。DateTimeOffset 表示使用 ISO 8601 格式的日期和时间信息,并且始终处于 UTC 时间。例如,2014 年 1 月 1 日午夜 UTC 类似于如下形式:'2014-01-01T00:00:00Z'Specifies when the post was last modified. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
newParticipantsnewParticipants recipient collectionrecipient collection 添加到此线程作为帖子一部分的对话参与者。Conversation participants that were added to the thread as part of this post.
receivedDateTimereceivedDateTime DateTimeOffsetDateTimeOffset 接收到帖子时指定。DateTimeOffset 表示使用 ISO 8601 格式的日期和时间信息,并且始终处于 UTC 时间。例如,2014 年 1 月 1 日午夜 UTC 类似于如下形式:'2014-01-01T00:00:00Z'Specifies when the post was received. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
sendersender recipientrecipient 包含发件人的地址未指定发件人时,发件人的值假定为已经过验证身份的用户的地址。这是默认属性。Contains the address of the sender. The value of Sender is assumed to be the address of the authenticated user in the case when Sender is not specified. This is a default property.

关系Relationships

关系Relationship 类型Type 说明Description
attachmentsattachments 附件 集合Attachment collection 只读。可为 NULL。Read-only. Nullable.
extensionsextensions 扩展集合Extension collection 为帖子定义的开放扩展集合。只读。可为 NULL。The collection of open extensions defined for the post. Read-only. Nullable.
inReplyToinReplyTo 帖子post 只读。Read-only.
multiValueExtendedPropertiesmultiValueExtendedProperties multiValueLegacyExtendedProperty 集合multiValueLegacyExtendedProperty collection 为帖子定义的多值扩展属性的集合。只读。可为 NULL。The collection of multi-value extended properties defined for the post. Read-only. Nullable.
singleValueExtendedPropertiessingleValueExtendedProperties singleValueLegacyExtendedProperty collectionsingleValueLegacyExtendedProperty collection 为帖子定义的单值扩展属性的集合。只读。可为 NULL。The collection of single-value extended properties defined for the post. Read-only. Nullable.

JSON 表示形式JSON representation

下面是资源的 JSON 表示形式。Here is a JSON representation of the resource

{
  "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"}
}

另请参阅See also