帖子资源类型post resource type

重要

Microsoft Graph 中/beta的版本下的 api 可能会发生更改。APIs under the /beta version in Microsoft Graph are subject to change. 在生产应用程序中不支持使用这些 API。Use of these APIs in production applications is not supported.

表示converstaionThread实体中的单个张贴项。Represents an individual post item within a converstaionThread 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.

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)",
  "importance": "string",
  "lastModifiedDateTime": "String (timestamp)",
  "newParticipants": [{"@odata.type": "microsoft.graph.recipient"}],
  "receivedDateTime": "String (timestamp)",
  "sender": {"@odata.type": "microsoft.graph.recipient"}
}

属性Properties

属性Property 类型Type 说明Description
bodybody itemBodyitemBody 帖子的内容。这是默认属性。此属性可为 NULL。The contents of the post. This is a default property. This property can be null.
类别categories String 集合String collection 与帖子关联的类别。The categories associated with the post. 每个类别对应于已为用户定义的outlookCategorydisplayName属性。Each category corresponds to the displayName property of an outlookCategory that has been defined for a user.
changeKeychangeKey 字符串String 标识帖子的版本。每次帖子更改时,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.
importanceimportance StringString 组帖子的重要性: lownormal、。 highThe importance of a group post: low, normal, high.
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 张贴内容的fileAttachmentitemAttachmentreferenceAttachment附件的集合。The collection of fileAttachment, itemAttachment, and referenceAttachment attachments for the post. 此为只读属性。Read-only. 可为 Null。Nullable.
extensionsextensions Extension 集合Extension collection 为帖子定义的开放扩展集合。只读。可为 NULL。The collection of open extensions defined for the post. Read-only. Nullable.
inReplyToinReplyTo 文章Post 此文章在conversationThread中答复的早期帖子。The earlier post that this post is replying to in the conversationThread. 只读。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.

方法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 attachment 附件attachment 将附件添加到帖子中。Add an attachment to a post.
开放扩展Open extensions
创建开放扩展Create open extension openTypeExtensionopenTypeExtension 创建开放扩展,并将自定义属性添加到新资源或现有资源。Create an open extension and add custom properties to a new or existing resource.
获取开放扩展Get open extension openTypeExtension 集合openTypeExtension collection 获取扩展名称标识的开放扩展。Get an open extension identified by the extension 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.

另请参阅See also