> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 概要

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

以下のページでは、X API に含まれる Spaces エンドポイントについて説明します。Spaces 全般の詳細については、[help.x.com](https://help.x.com/en/using-twitter/spaces) を参照してください。 

Spaces は、ライブ音声での会話を通じて表現とインタラクションを可能にします。Spaces エンドポイントは、Spaces を活用した新しい機能を作成するためのツールを提供します。これらのエンドポイントを使用して、ライブ中またはスケジュール済みの Spaces を取得したり、ユーザーが興味を持ちそうな Spaces を見つけられるような発見のためのエクスペリエンスを構築したりできます。

私たちは、Spaces を私たちが構築した形にとどめず、皆さんの創造性で拡張していただくことを歓迎します。これらのエンドポイントを使って、タイトルに含まれるキーワードに基づいてリスナーに Spaces を提案するエクスペリエンスを構築したり、ライブまたは今後の Spaces をホストしていて、かつユーザーにフォローされているアカウントを可視化したりできます。また、ホストが自分の Spaces のパフォーマンスをよりよく理解し、オーディエンスに関するインサイトを得られるよう支援することも可能です。

<div id="important-resources">
  ### 重要なリソース
</div>

以下のリソースは、Spaces エンドポイントの利用開始や統合に役立ちます。

* [X API v2 へのアクセス権を取得する](/ja/x-api/getting-started/getting-access)
* [Spaces データ辞書](/ja/x-api/fundamentals/data-dictionary#space)
* [Spaces エンドポイントへの最初のリクエストを行う](/ja/x-api/spaces/lookup/introduction)

   

<div id="whats-currently-available">
  #### 現在利用可能な機能
</div>

|                    |                                                                                                                                                                                                                                                                                                                                                     |
| :----------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Spaces のルックアップ** | [単一の Spaces ID で取得する](/ja/x-api/spaces/space-lookup-by-space-id)<br /><br />[複数の Spaces ID を使って取得する](/ja/x-api/spaces/space-lookup-up-space-ids)<br /><br />[作成者 ID で取得する](/ja/x-api/spaces/space-lookup-by-their-creators)<br /><br />[チケット購入者のユーザー一覧を取得する](/ja/x-api/spaces/retrieve-the-list-of-users-who-purchased-a-ticket-to-the-given-space) |
| **Spaces の検索**     | [キーワードを使って Spaces を検索する](/ja/x-api/spaces/search-for-spaces)                                                                                                                                                                                                                                                                                        |

<div id="understanding-the-lifecycle-of-spaces">
  #### Spaces のライフサイクルを理解する
</div>

X Developer Platform の他のリソースとは異なり、Spaces には明確なライフサイクルがあります。Spaces は開始予定日時の最大 14 日前までスケジュールでき、終了後は利用できなくなります。ホストは、開始前であればいつでも、すでにスケジュールした Space をキャンセルすることもできます。

Space がライブ中はアクセス可能ですが、終了すると Spaces エンドポイントを使って取得することはできなくなり、この状態を示すエラーメッセージが返されます。

あなたの App が Spaces のデータを扱う場合、常に最新の情報を返すとともに、プラットフォーム上で利用できなくなったデータを削除する責任があります。[Spaces lookup endpoint](/ja/x-api/spaces/lookup/introduction) を利用することで、ユーザーの期待や意図を尊重した形でデータを扱えていることを確保しやすくなります。
 

<div id="roles-in-spaces">
  ### Spaces におけるロール
</div>

これらのエンドポイントは、X App における Spaces の動作を反映しています。Spaces では、X ユーザーは Space との関わり方や Space 内での振る舞いに応じて、特定のロールが割り当てられます。
 

<div id="creator-or-primary-host">
  ### クリエイター (またはプライマリホスト)
</div>

プライマリホストは、Space を作成したユーザーであり、その Space 自体の所有者です。現在、Space はホストを 1 人しか持てないため、プライマリホストが唯一のホストとなります。[Spaces data dictionary](/ja/x-api/fundamentals/data-dictionary#space) では、プライマリホストの情報は `creator_id` フィールドに含まれており、[ユーザーオブジェクト](/ja/x-api/fundamentals/data-dictionary#user) に展開することができます。
 

<div id="hosts">
  ### ホスト
</div>

プライマリホストは、1 人以上のユーザーを共同ホストとして追加できます。Spaces のデータディクショナリでは、これらのホストは host\_ids として表示され、ユーザーオブジェクトのリストに展開できます。Space の開催中はホストの指定が変更される可能性があり、これらのエンドポイントから返されるメタデータは、リクエスト時点の状態を反映します。

App は、creator\_id の値を確認することでプライマリホストを、host\_ids の値を確認することで共同ホストを判別できます。
 

<div id="speaker">
  ### スピーカー
</div>

スピーカーとは、スペース内で発言する権限を持つユーザーのことです。任意の時点で 0 人以上のスピーカーが存在でき、スペースにはホストを含めて最大 10 人までのスピーカーが参加できます。Space データ辞書では、スピーカーは `speaker_ids` リストとして返され、これを展開してユーザーオブジェクトのリストに変換できます。
 

<div id="listener">
  ### リスナー
</div>

リスナーはスペースを視聴し、あらかじめ定義されたリアクションをいつでも使用して反応でき、 (ホストがスペースの設定でこれを許可している場合は) スピーカーになることをリクエストすることもできます。リスナーに関する情報は、participant\_count フィールドで返される参加者数 (ホストを含む) の集計値としてのみ取得できます。