Vai al contenuto principale
Con le expansions, gli sviluppatori possono includere oggetti a cui si fa riferimento nel payload. Gli oggetti disponibili per le expansions sono indicati tramite id. Ad esempio, i campi referenced_tweets.id e author_id restituiti nel payload di Posts lookup possono essere espansi in oggetti completi. Se desideri richiedere i fields relativi all’utente che ha pubblicato quel Post, oppure ai contenuti multimediali, al sondaggio o al luogo inclusi in quel Post, dovrai passare il relativo parametro di query expansions nella tua richiesta per ricevere quei data nella risposta. Attualmente, gli endpoint v2 che restituiscono Posts, utenti, Lists, Spaces e oggetti evento dei Messaggi Diretti supportano tutti le expansions (vedi esempi sotto). Quando includi una expansion nella tua richiesta, includeremo i fields predefiniti di quell’oggetto espanso all’interno della stessa risposta. Questo consente di ottenere data aggiuntivi nella stessa risposta senza la necessità di richieste separate. Se desideri richiedere ulteriori fields relativi all’oggetto espanso, puoi includere il parametro fields associato a quell’oggetto, insieme a un elenco di fields separati da virgole che desideri ricevere nella risposta. Tieni presente che i fields non vengono sempre restituiti nello stesso ordine in cui sono stati richiesti nella query. Il payload del Post riportato di seguito contiene id di riferimento per oggetti complementari su cui possiamo effettuare l’espansione, inclusi l’author_id di chi ha pubblicato il Post, l’id di un Post referenziato e una media_key per un allegato multimediale. 
{
    "data": {
        "attachments": {
            "media_keys": ["16_1211797899316740096"]
        },
        "author_id": "2244994945",
        "id": "1212092628029698048",
        "referenced_tweets": [
            {
                "type": "replied_to",
                "id": "1212092627178287104"
            }
        ],
        "text": "Crediamo che la migliore versione futura della nostra API nascerà costruendola insieme a VOI. Un brindisi a un altro anno straordinario con tutti coloro che sviluppano sulla piattaforma Twitter. Non vediamo l’ora di continuare a collaborare con voi nel nuovo anno. https://t.co/yvxdK6aOo2"
    }
}

​
Espansioni disponibili per i payload dei Post

ExpansionDescrizione
author_idRestituisce un oggetto utente che rappresenta l’autore del Post
referenced_tweets.idRestituisce un Oggetto Post a cui questo Post fa riferimento (come Retweet, Quoted Tweet o risposta)
edit_history_tweet_idsRestituisce Oggetti Post che fanno parte della cronologia delle modifiche del Post
in_reply_to_user_idRestituisce un oggetto utente che rappresenta l’autore del Post a cui questo Post richiesto è una risposta
attachments.media_keysRestituisce un oggetto media che rappresenta le immagini, i video e le GIF incluse nel Post
attachments.poll_idsRestituisce un oggetto sondaggio contenente i metadata del sondaggio incluso nel Post
geo.place_idRestituisce un oggetto luogo contenente i metadata per la posizione taggata nel Post
entities.mentions.usernameRestituisce un oggetto utente per l’utente menzionato nel Post
referenced_tweets.id.author_idRestituisce un oggetto utente per l’autore del Post di riferimento

​
Espansioni disponibili per i payload utente

EspansioneDescrizione
pinned_tweet_idRestituisce un Oggetto Post che rappresenta il Post fissato in alto nel profilo dell’utente

​
Espansioni disponibili per i payload degli eventi di Messaggistica Diretta

ExpansionDescription
attachments.media_keysRestituisce un oggetto Media allegato a un messaggio diretto
referenced_tweets.idRestituisce un Oggetto Post a cui si fa riferimento in un messaggio diretto
sender_idRestituisce un oggetto utente che rappresenta l’autore di un messaggio diretto e la persona che ha invitato un partecipante a unirsi a una conversazione
participant_idsRestituisce un oggetto utente che rappresenta un partecipante che si è unito o ha lasciato una conversazione

​
Espansioni disponibili per i payload di Spaces

ExpansionDescrizione
invited_user_idsRestituisce oggetti utente che rappresentano gli account invitati
speaker_idsRestituisce oggetti utente che rappresentano gli account che hanno parlato durante uno Space
creator_idRestituisce un oggetto utente che rappresenta l’account che ha creato lo Space
host_idsRestituisce oggetti utente che rappresentano gli account impostati come host
topics_idsRestituisce le descrizioni degli argomenti configurati dal creatore

​
Espansioni disponibili per i payload delle List

EspansioneDescrizione
owner_idRestituisce un oggetto utente che rappresenta l’account che ha creato e che gestisce la List

​
Espansione dell’oggetto Media

Nella richiesta seguente, chiediamo l’espansione di geo.place_id da includere insieme ai Post fields predefiniti: Esempio di richiesta 
{`curl 'https://api.x.com/2/tweets/:ID?expansions=geo.place_id' --header 'Authorization: Bearer $ACCESS_TOKEN'`}
Esempio di risposta 
{`{
  "data": {
      "geo": {
          "place_id": "01a9a39529b27f36"
      },
      "id": "ID",
      "text": "Prova"
  },
  "includes": {
      "places": [
          {
              "full_name": "Manhattan, NY"
              "id": "01a9a39529b27f36"
          }
      ]
  }
}`}

​
Espansione dell’oggetto Poll

Nella richiesta seguente, chiediamo l’expansion attachments.poll_ids da includere insieme ai campi Post predefiniti: Richiesta di esempio Risposta di esempio 
{`{
  "data": {
      "attachments": {
          "poll_ids": ["1199786642468413448"]
      },
      "id": "1199786642791452673",
      "text": "C#"
  },
  "includes": {
      "polls": [
          {
              "id": "1199786642468413448",
              "options": [
                  {
                      "position": 1,
                      "label": "“C Sharp”"
                      "votes": 795
                  },
                  {
                      "position": 2,
                      "label": "“C cancelletto”"
                      "votes": 156
                  }
              ]
          }
      ]
  }
}`}

​
Espansione dell’oggetto Place

Nella richiesta seguente richiediamo l’espansione geo.place_id da includere insieme ai campi Post predefiniti: Esempio di richiesta Esempio di risposta 
{`{
  "data": {
      "geo": {
          "place_id": "01a9a39529b27f36"
      },
      "id": "ID",
      "text": "Prova"
  },
  "includes": {
      "places": [
          {
              "full_name": "Manhattan, NY"
              "id": "01a9a39529b27f36"
          }
      ]
  }
}`}
⌘I