Recursos importantes
- Obtener acceso a X API v2
- Diccionario de datos de Spaces
- Haga su primera solicitud a un endpoint de Spaces
Spaces
Introducción
La siguiente página describe los endpoints de Spaces incluidos en la X API. Para obtener más información sobre Spaces en general, visita help.x.com.
Spaces permite la expresión y la interacción mediante conversaciones de audio en vivo. Los endpoints de Spaces proporcionan herramientas para crear nuevas funciones en torno a Spaces. Puedes usar estos endpoints para buscar Spaces en vivo o programados, o para crear experiencias de descubrimiento que ofrezcan a tus usuarios formas de encontrar Spaces que puedan interesarles.
Te animamos a usar tu creatividad para ampliar Spaces más allá de cómo lo creamos. Con estos endpoints puedes crear experiencias para sugerir Spaces a los oyentes basadas en palabras clave presentes en el título, o destacando cuentas que organizan Spaces en vivo o próximos y que un usuario sigue; también puedes ayudar a los hosts a comprender mejor el rendimiento de sus Spaces y obtener más información sobre su audiencia.
Los siguientes recursos le ayudarán a comenzar e integrarse con los endpoints de Spaces:
A diferencia de otros recursos de la X Developer Platform, Spaces tienen un ciclo de vida definido. Se pueden programar hasta 14 días antes de su fecha de inicio prevista y dejan de estar disponibles una vez que finalizan. Un anfitrión también puede cancelar un Space programado previamente en cualquier momento antes de que comience.
Los Spaces son accesibles mientras están en vivo; una vez que terminan, ya no estarán disponibles para su obtención mediante los endpoints de Spaces y se devolverá un mensaje de error para indicar esta condición.
Cuando tu App maneja data de Spaces, eres responsable de proporcionar la información más actualizada y de eliminar la data que ya no esté disponible en la plataforma. El endpoint de búsqueda de Spaces puede ayudarte a garantizar que respetas las expectativas y la intención de tus usuarios.
Estos endpoints reflejan el modo en que funcionan los Spaces en la App de X. En Spaces, los usuarios de X pueden tener roles definidos según cómo interactúan con y participan en un Space.
El anfitrión principal es el usuario que creó un Space y el propietario del Space. Actualmente, los Spaces solo pueden tener un anfitrión, por lo que el anfitrión principal será el único anfitrión. En el diccionario de datos de Spaces, la información del anfitrión principal estará en el campo creator_id, que puede expandirse a un objeto de usuario.
Los anfitriones principales pueden designar a uno o más usuarios como coanfitriones. En el diccionario de datos de Spaces, estos anfitriones aparecerán como host_ids, que pueden expandirse en una lista de objetos de usuario. La designación de anfitrión puede cambiar durante la duración de un Space, y los metadatos que devuelven estos endpoints reflejarán el estado en el momento de la solicitud.
Tu App identificará al anfitrión principal consultando el valor de creator_id y a los coanfitriones consultando los valores de host_ids.
Los oradores son usuarios que tienen permiso para hablar en el Space. Puede haber cero o más oradores en cualquier momento y puede haber hasta 10 oradores (incluidos los hosts) en un Space. En el diccionario de datos de Space, los oradores se devolverán en la lista speaker_ids, que puedes expandir en una lista de objetos de usuario.
Un Listener puede escuchar un Space, reaccionar en cualquier momento con las reacciones predefinidas y solicitar convertirse en orador (cuando los Hosts lo permiten en la configuración del Space). La información del Listener solo se devolverá como un recuento agregado de participantes (incluidos los Hosts) en el campo participant_count.
⌘I