メインコンテンツへスキップ

トピックごとに返信を管理する

Hide replies エンドポイントを通じて、人やブランドが会話をトピックから逸脱しないように保つための連携機能を構築できます。このページでは、Hide replies と recent search エンドポイントを使用して会話を管理する方法を説明します。 Recent search には会話とその返信を取得する機能があり、ポストのペイロードは Post annotations を返します。これにより、言語に関係なく、各ポストのコンテキストとトピックを理解することができます。 App のフローには、会話を表示および管理するための操作が含まれます。
  1. ユーザーの投稿を読み取り、その返信を管理するための許可をユーザーに求めます。
  2. ポストの URL から最近の会話を取得し、その会話が認証中のユーザーのものであることを確認します。
  3. Recent search エンドポイントを呼び出して、会話内の各ポストを表示します。リクエストには、会話 ID の検索クエリとアノテーションの拡張を含め、X によるポストの解釈に基づいて、そのポストがスポーツ関連かどうかを判定します。
  4. ユーザーが選択したときに返信を非表示にするために Hide replies を呼び出します。また、ユーザーが常に操作を制御できるよう、このアクションを取り消す手段も提供します。 
  5. 長い会話の場合は、検索結果をページネーションするための操作を提供します。  

ユーザー (と利用状況) に最適化する

ユーザーが行おうとしている操作を自分でコントロールできるようにフローを設計できます。この原則を念頭に置くことで、ポストの閲覧体験を最適化できるようなインテグレーションを構築することにもつながります。
  1. 認証済みユーザーは自分が開始した会話のみ管理できるため、その条件を満たさない場合はフローを早期に終了させる必要があります。
    • 最初にポストのルックアップリクエストを行います。ポストの URL が有効でない場合や、その会話が認証済みユーザーによって開始されていない場合は、フローを早期に終了させます。
    • こうすることで、会話が認証済みユーザーによってモデレートできない場合に、アプリが recent search エンドポイントへのリクエストを行う必要がなくなります。
  2. 個別のリクエストを発行しなくて済むように、同じリクエスト内で user と Post のフィールド を要求します。この方法はアプリのパフォーマンス向上にも役立ちます。
  3. 不要なリクエストは行わないようにします。このアプリは、返信が非表示かどうかのステータスをユーザーのブラウザーにキャッシュします。これは、大規模な会話でユーザーが後からモデレーションを再開したい場合に便利であり、アプリが返信を非表示・再表示するためのリクエストを最適化するうえでも役立ちます。