Bewerken

Delen via


post resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

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 post None Reply to a post and add a new post to the specified thread in a group conversation.
Forward post None Forward a post to a recipient.
Attachments
List attachments attachment collection Get all attachments on a post.
Add attachment attachment Add an attachment to a post.
Open extensions
Create open extension openTypeExtension Create an open extension and add custom properties to a new or existing resource.
Get open extension openTypeExtension collection Get an open extension identified by the extension name.
Extended properties
Create single-value property post Create one or more single-value extended properties in a new or existing post.
Get single-value property post Get posts that contain a single-value extended property by using $expand or $filter.
Create multi-value property post Create one or more multi-value extended properties in a new or existing post.
Get multi-value property post Get a post that contains a multi-value extended property by using $expand.

Properties

Property Type Description
body itemBody The contents of the post. This is a default property. This property can be null.
categories String collection The categories associated with the post. Each category corresponds to the displayName property of an outlookCategory that has been defined for a user.
changeKey String 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.
conversationId String Unique ID of the conversation. Read-only.
conversationThreadId String Unique ID of the conversation thread. Read-only.
createdDateTime DateTimeOffset 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 is 2014-01-01T00:00:00Z
from recipient Used in delegate access scenarios. Indicates who posted the message on behalf of another user. This is a default property.
hasAttachments Boolean Indicates whether the post has at least one attachment. This is a default property.
id String Read-only.
importance importance The importance of a group post: low, normal, high.
lastModifiedDateTime DateTimeOffset 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 is 2014-01-01T00:00:00Z
newParticipants recipient collection Conversation participants that were added to the thread as part of this post.
receivedDateTime DateTimeOffset 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 is 2014-01-01T00:00:00Z
sender recipient 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
attachments Attachment collection The collection of fileAttachment, itemAttachment, and referenceAttachment attachments for the post. Read-only. Nullable. Supports $expand.
extensions Extension collection The collection of open extensions defined for the post. Read-only. Nullable. Supports $expand.
inReplyTo Post The earlier post that this post is replying to in the conversationThread. Read-only. Supports $expand.
multiValueExtendedProperties multiValueLegacyExtendedProperty collection The collection of multi-value extended properties defined for the post. Read-only. Nullable.
singleValueExtendedProperties singleValueLegacyExtendedProperty collection The collection of single-value extended properties defined for the post. Read-only. Nullable.

JSON representation

The following JSON representation shows the resource type.

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