对话资源类型conversation resource type

对话是 线程 集合,而线程包含相应线程拥有的帖子。对话中的所有线程和帖子共享相同的主题。A conversation is a collection of threads, and a thread contains posts to that thread. All threads and posts in a conversation share the same subject.

此资源支持订阅更改通知This resource supports subscribing to change notifications.

方法Methods

方法Method 返回类型Return Type 说明Description
列出对话List conversations conversation 集合conversation collection 获取此组中的对话列表。Get the list of conversations in this group.
创建Create 对话conversation 通过包括线程和帖子创建新对话。Create a new conversation by including a thread and a post.
获取对话Get conversation conversationconversation 读取 conversation 对象的属性和关系。Read properties and relationships of conversation object.
删除Delete None 删除 conversation 对象。Delete conversation object.
列出对话线程List conversation threads conversationThread 集合conversationThread collection 获取组对话中的所有线程。Get all the threads in a group conversation.
创建对话线程Create conversation thread conversationThread 集合conversationThread collection 在指定会话中创建线程。Create a thread in the specified conversation.

属性Properties

属性Property 类型Type 说明Description
hasAttachmentshasAttachments BooleanBoolean 指示此对话中的任意帖子是否至少有一个附件。Indicates whether any of the posts within this Conversation has at least one attachment.
idid StringString 对话的唯一标识符。只读。The conversations's unique identifier. Read-only.
lastDeliveredDateTimelastDeliveredDateTime DateTimeOffsetDateTimeOffset 时间戳类型表示使用 ISO 8601 格式的日期和时间信息,并且始终处于 UTC 时间。例如,2014 年 1 月 1 日午夜 UTC 如下所示:'2014-01-01T00:00:00Z'The Timestamp 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'
previewpreview StringString 来自此对话中最新帖子的正文的简短摘要。A short summary from the body of the latest post in this converstaion.
topictopic StringString 对话的主题。在创建对话时可设置此属性,但无法对其进行更新。The topic of the conversation. This property can be set when the conversation is created, but it cannot be updated.
uniqueSendersuniqueSenders String collectionString collection 发送消息到此对话的所有用户。All the users that sent a message to this Conversation.

关系Relationships

关系Relationship 类型Type 说明Description
threadsthreads conversationThread 集合conversationThread collection 对话中所有对话线程的集合。一种导航属性。只读。可为 NULL。A collection of all the conversation threads in the conversation. A navigation property. Read-only. Nullable.

JSON 表示形式JSON representation

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

{
  "hasAttachments": true,
  "id": "string (identifier)",
  "lastDeliveredDateTime": "String (timestamp)",
  "preview": "string",
  "topic": "string",
  "uniqueSenders": ["string"],

  "threads": [{"@odata.type": "microsoft.graph.conversationThread"}]
}