Risorse importanti
- Ottenere l’accesso a X API v2
- Dizionario dei dati di Spaces
- Effettua la tua prima richiesta a un endpoint Spaces
Spaces
Introduzione
La pagina seguente descrive gli endpoint di Spaces inclusi nella X API. Per ulteriori informazioni su Spaces in generale, visita help.x.com.
Spaces consente l’espressione e l’interazione tramite conversazioni audio in diretta. Gli endpoint di Spaces offrono strumenti per creare nuove funzionalità attorno a Spaces. Puoi utilizzare questi endpoint per cercare Spaces live o programmati oppure per creare esperienze di scoperta che aiutino i tuoi utenti a trovare Spaces di loro interesse.
Ti invitiamo a usare la tua creatività per estendere Spaces oltre come l’abbiamo progettato. Con questi endpoint puoi creare esperienze per suggerire agli ascoltatori Spaces in base alle parole chiave presenti nel titolo oppure mettendo in evidenza gli account che ospitano Spaces live o imminenti e che sono seguiti da un utente; puoi anche aiutare gli host a comprendere meglio le prestazioni dei loro Spaces e ottenere approfondimenti sul loro pubblico.
Le seguenti risorse ti aiuteranno a iniziare e a integrare gli endpoint Spaces:
A differenza di altre risorse della X Developer Platform, Spaces ha un ciclo di vita definito. Le sessioni di Spaces possono essere pianificate fino a 14 giorni prima della data di inizio prevista e diventano non disponibili dopo la loro conclusione. Un host può anche annullare una sessione di Spaces precedentemente pianificata in qualsiasi momento prima dell’avvio.
Le sessioni di Spaces sono accessibili mentre sono live; una volta concluse, non saranno più disponibili per il recupero tramite gli endpoint di Spaces e verrà restituito un messaggio di errore per indicare questa condizione.
Quando la tua App gestisce i dati di Spaces, sei responsabile di fornire le informazioni più aggiornate e di rimuovere i dati che non sono più disponibili sulla piattaforma. L’endpoint di lookup di Spaces può aiutarti a garantire il rispetto delle aspettative e dell’intento dei tuoi utenti.
Questi endpoint rispecchiano il funzionamento delle Spaces sull’App X. Nelle Spaces, gli utenti di X possono avere ruoli specifici in base a come interagiscono con una Space e al loro ruolo al suo interno.
L’host principale è l’utente che ha creato uno Space ed è il proprietario dello Space stesso. Attualmente, gli Spaces possono avere un solo host, quindi l’host principale sarà l’unico host. Nel dizionario dei dati di Spaces, le informazioni sull’host principale sono nel campo creator_id, che può essere espanso in un oggetto utente.
Gli Host principali possono nominare uno o più utenti come co‑host. Nel dizionario dei dati di Spaces, questi Host compaiono come host_ids, che è possibile espandere in un elenco di oggetti utente. La designazione di Host può cambiare per tutta la durata di uno Space e i metadati restituiti da questi endpoint rifletteranno lo stato al momento della richiesta.
La tua App identificherà l’host principale controllando il valore creator_id e i co‑host controllando i valori host_ids.
I relatori sono utenti che hanno l’autorizzazione a parlare nello Space. In qualsiasi momento possono essere presenti da zero a più relatori e in uno Space possono essercene fino a 10 (inclusi gli Host). Nel data dictionary dello Space, i relatori verranno restituiti nella lista speaker_ids, che puoi espandere in un elenco di oggetti utente.
Un Listener può ascoltare uno Space, reagire in qualsiasi momento utilizzando le reazioni predefinite e chiedere di diventare speaker (quando gli Host lo consentono nelle impostazioni dello Space). Le informazioni sui Listener saranno restituite solo come conteggio aggregato dei partecipanti (inclusi gli Host) nel campo participant_count.
⌘I