跳转到主要内容
通过 Hide replies 端点,你可以构建集成,帮助个人和品牌让对话保持在主题之内。本文展示如何使用 Hide replies 和 recent search 端点来管理一段对话。
Recent search 具备定位一段对话及其回复的功能,而 Post 负载会返回 Post annotations,帮助你理解每条 Post 的上下文和主题,不受语言影响。
应用的流程将包含用于显示和管理对话的控件:
-
请求用户授权读取其 Posts 并管理其回复。
-
从一个 Post URL 获取一段最近的对话,并检查该对话是否来自已认证用户。
-
调用 recent search 端点来显示对话中的每条 Post。请求将包含会话 ID 的搜索查询以及注释扩展,用于根据 X 对该 Post 的解读来判断该 Post 是否与体育相关。
-
当用户选择时,调用 Hide replies 隐藏某条回复。同时也会提供撤销该操作的方式,以便用户始终保持掌控。
-
对于较长的对话,将提供控件以分页浏览搜索结果。
你可以将流程设计为让用户掌控其打算执行的任何操作。牢记这一原则也有助于你构建能够优化 Post 消费的集成方案。
- 由于仅已认证用户才能管理由其本人发起的会话,当不满足该条件时,你的流程应尽早终止。
- 先发起一次 Post 初始查找请求。如果 Post URL 无效或会话并非由进行身份验证的用户发起,则应尽早终止流程。
- 这样,如果已认证用户无法对该会话进行管理,你的应用就无需再发起最近搜索请求。
- 在同一请求中同时请求用户和 Post fields,以避免分别发起请求。这种做法也能提升应用性能。
- 在非必要时避免发起请求。此应用会在用户的浏览器中缓存回复的隐藏状态。这在较大的会话中很有用,用户可能希望稍后继续其治理工作,同时也有助于你的应用优化隐藏或取消隐藏回复时的请求量。