Skip to main content
以下のページでは、X API に含まれる Spaces エンドポイントについて説明します。Spaces 全般について詳しく知りたい場合は、help.x.com をご覧ください。 Spaces では、ライブ音声会話を通じて表現やインタラクションが可能です。Spaces エンドポイントは、Spaces を中心とした新しい機能を作るためのツールを提供します。これらのエンドポイントを使用して、開催中または予定されている Spaces をルックアップしたり、ユーザーが興味を持ちそうな Spaces を見つけるためのディスカバリ体験を構築したりできます。 私たちが構築したやり方を超えて Spaces を拡張するために、皆さんの創造性を発揮してください。これらのエンドポイントを使用すると、タイトルに含まれるキーワードに基づいてリスナーに Spaces を提案したり、ユーザーがフォローしているアカウントが開催中または今後開催予定の Spaces をホストしている場合にそれらのアカウントを表示したりする体験を構築できます。また、ホストが自分の Spaces のパフォーマンスをよりよく理解し、視聴者に関するさらに多くのインサイトを得るのを助けることもできます。

​
重要なリソース

以下のリソースは、Spaces エンドポイントの利用を始めて統合するのに役立ちます:

​
現在利用可能なもの

​
Spaces のライフサイクルを理解する

X 開発者プラットフォームの他のリソースとは異なり、Spaces には決まったライフサイクルがあります。Spaces は開始予定日の最大 14 日前までにスケジュール設定でき、終了後は利用不可となります。ホストは、開始前であればいつでも予定していた Space をキャンセルすることもできます。 Spaces はライブ中のみアクセス可能です。終了した Space は Spaces エンドポイントで取得できなくなり、その状態を示すエラーメッセージが返されます。 アプリで Spaces データを扱う際は、最新の情報を返す責任があります。また、プラットフォームで利用できなくなったデータを削除する責任もあります。Spaces ルックアップエンドポイントは、ユーザーの期待と意図を尊重するのに役立ちます。

​
Spaces でのロール

これらのエンドポイントは、X アプリでの Spaces の動作を反映しています。Spaces では、X ユーザーは Space での関わり方に応じて定義されたロールを持つことができます。

​
Creator (または primary host)

Primary Host とは、Space を作成したユーザーであり、Space 自体のオーナーです。現在、Spaces は 1 人のホストしか持てないため、primary Host が唯一のホストとなります。Spaces データディクショナリでは、primary Host 情報は creator_id フィールドに含まれ、user オブジェクトに展開できます。

​
Hosts

Primary Hosts は 1 人以上のユーザーを共同ホストにすることができます。Spaces データディクショナリでは、これらのホストは host_ids として表示され、user オブジェクトのリストに展開できます。ホスト指定は Space の継続期間中に変更される可能性があり、これらのエンドポイントから返されるメタデータはリクエスト時点のステータスを反映します。 アプリは creator_id 値を確認して primary host を、host_ids 値を確認して共同ホストが誰かを把握できます。

​
Speaker

Speakers は Space 内で発言する権限を持つユーザーです。任意の時点で 0 人以上の Speakers が存在し、Space には最大 10 人(ホストを含む)の Speakers が存在できます。Space データディクショナリでは、speakers は speaker_ids リストで返され、user オブジェクトのリストに展開できます。

​
Listener

Listener は Space を聴くことができ、事前定義されたリアクションを使用していつでも反応したり、(ホストが Space 設定で許可している場合は) speaker になることをリクエストしたりできます。Listener 情報は participant_count フィールドで参加者数(ホストを含む)の集計値としてのみ返されます。