microsoft-graph-api - conversationThread 和 conversation 有什么区别？

Question

我正在调查文档，我不清楚 Microsoft Graph(v1.0 引用)上的 conversationThread 和 conversation 之间到底有什么区别？

conversation 的文档声明:一个对话是线程的集合，一个线程包含该线程的帖子。对话中的所有线程和帖子共享相同的主题。 关系是线程。在这里，我假设同一主题是指在该对话的范围内？

另一方面，conversationThread 的文档声明:conversationThread 是帖子的集合。最后一个帖子的收件人集合是整个线程的聚合收件人。线程可以有越来越多的收件人。当从线程中删除收件人时，将创建一个新线程。 关系是帖子。这里没有任何线索，如果 conversationThread 是帖子的集合，那与 conversation 提供的内容几乎相同？

我一直在努力做什么？我正在使用 Fiddler 处理 HTTP 请求 groups/<id>/conversations和 groups/<id>/threads我注意到最明显的区别是 threads有一个 isLocked属性conversations没有。然后我脑海中浮现出一个问题:“为什么以及在什么情况下我会使用 group/<id>/threads 而不是 group/<id>/conversations 呢？”。可能是因为我不明白conversationThread 和conversation 之间的区别。

请记住，我是 Microsoft Graph 的新手，如果社区可以帮助我澄清这个问题，我将不胜感激。

非常感谢!

编辑使用 Fiddler，我们成功地创建了一个新线程。但是，它并没有像预期的那样在指定的对话中创建新线程，而是创建了一个新对话以与新线程一起使用。 A 还尝试在新创建的线程中创建新帖子，但我遇到以下错误:“不支持 OData 请求”使用请求正文:“
{
"body": {
"contentType": "application/json",
"content": "This is a test"
}
}”

Answer 1

感谢您对群组对话 API 的关注和试用。关于您的几个问题，我想与您分享我的理解:

• “conversationThread 和 conversation on Microsoft Graph(v1.0 引用)到底有什么区别？”

• “为什么以及在什么情况下我会使用组//线程而不是组//对话？”

就群组对话功能设计而言，正如您可能已经读到的那样，帖子始终是某个线程的一部分，而该线程始终是某个对话的一部分。在 API 支持方面，API 提供对话和线程之间的“对等”——不需要您始终为帖子引用父对话的便利。需要明确的是，这并不意味着您可以在没有家长对话的情况下发布帖子或主题；您只是不必在每次访问现有线程或帖子时都必须引用父对话。我将从创建帖子开始:如果您想开始在新对话中发帖，为方便起见，有几种方法可以做到:

(a) 你可以先create a conversation (POST/groups//对话)。您将指定一个新线程并在请求正文中发布。成功的查询将创建新的对话、线程和帖子。

(b) 或者，您可以 create a thread without referencing any existing conversation (POST/groups//threads)。您将指定新线程并在请求正文中发布。成功的查询将创建一个包含该新线程和帖子的新对话。

创建帖子后，您可以使用其 ID 来获取、回复、转发、创建或访问该帖子的附件，方法是同时指定父对话和线程，或者仅指定父线程。这就是所谓的 session 和线程的奇偶校验。

• “在这里，我假设同一个主题是指在那次谈话的范围内？”

是的，一个对话、它的线程和帖子都共享同一个主题。我认为这里的“主题”是由主题属性表示的。

• “如果 conversationThread 是帖子的集合，那与 conversation 提供的功能几乎相同？”

在对话中将线程和帖子拉到一起的是“主题”。在最终用户场景中考虑一下——一旦对话中的某个人改变了主题，那个人就会开始新的对话。在对话中，有时参与者可以从原始参与者的子集衍生出一个副线程。这构成了一个新的“线程”，因为主题保持不变，只是参与者减少了。这就是 session 和线程之间的功能设计差异。在 API 功能方面，您可以回复线程(或帖子)并引用父线程，但不能仅通过引用父对话来回复。

• “还尝试在新创建的话题中创建新帖子”

我怀疑您对现有线程进行了 POST 以尝试创建帖子？

如果是这样，我想指出您不能使用 POST 创建新的组帖子。您可以通过以下方式之一创建帖子:- 创建新对话时 (POST/groups//conversations)- 创建新线程时 (POST/groups//threads)- 回复主题时- 回复帖子时

希望对您有所帮助。

天使高尔夫女士