Erweiterungen

Mit Erweiterungen können Entwickler Objekte auflösen, auf die im Payload verwiesen wird. Für die Erweiterung verfügbare Objekte werden über ihre ID referenziert. Beispielsweise können die Felder referenced_tweets.id und author_id, die im Posts Lookup-Payload zurückgegeben werden, zu vollständigen Objekten erweitert werden. Wenn Sie Felder anfordern möchten, die sich auf den Nutzer beziehen, der diesen Post veröffentlicht hat, oder auf die Medien, die Umfrage oder den Ort, die in diesem Post enthalten waren, müssen Sie den zugehörigen expansions-Abfrageparameter in Ihrer Anfrage übergeben, um diese data in Ihrer Antwort zu erhalten. Derzeit unterstützen v2-endpoints, die Posts, Nutzer, Lists, Spaces und Direct-Message-Ereignisobjekte zurückgeben, Erweiterungen (siehe Beispiele unten).

Wenn Sie eine Erweiterung in Ihre Anfrage aufnehmen, fügen wir die Standardfelder des erweiterten Objekts in derselben Antwort bei. Dies ermöglicht die Rückgabe zusätzlicher data in derselben Antwort, ohne dass separate Anfragen erforderlich sind. Wenn Sie zusätzliche fields anfordern möchten, die sich auf das erweiterte Objekt beziehen, können Sie den mit diesem erweiterten Objekt verknüpften fields-Parameter zusammen mit einer durch Kommas getrennten Liste von Feldern einschließen, die Sie in Ihrer Antwort erhalten möchten. Bitte beachten Sie, dass Felder nicht immer in der Reihenfolge zurückgegeben werden, in der sie in der Abfrage angefordert wurden.

Der folgende Post-Payload enthält Referenz-IDs für ergänzende Objekte, die wir erweitern können, darunter die author_id des Nutzers, der den Post veröffentlicht hat, die id eines referenzierten Posts und ein media_key für einen Medienanhang.

{
    "data": {
        "attachments": {
            "media_keys": ["16_1211797899316740096"]
        },
        "author_id": "2244994945",
        "id": "1212092628029698048",
        "referenced_tweets": [
            {
                "type": "replied_to",
                "id": "1212092627178287104"
            }
        ],
        "text": "Wir sind überzeugt, dass die beste künftige Version unserer API daraus entstehen wird, sie gemeinsam mit IHNEN zu entwickeln. Auf ein weiteres großartiges Jahr mit allen, die auf der Twitter‑Plattform bauen. Wir können es kaum erwarten, im neuen Jahr weiterhin mit Ihnen zusammenzuarbeiten. https://t.co/yvxdK6aOo2"
    }
}

​

Verfügbare Expansions für Post-Payloads

Expansion	Beschreibung
author_id	Gibt ein User-Objekt zurück, das den Autor des Posts repräsentiert
referenced_tweets.id	Gibt ein Post-Objekt zurück, auf das sich dieser Post bezieht (als Retweet, Zitierter Tweet oder Antwort)
edit_history_tweet_ids	Gibt Post-Objekte zurück, die Teil der Bearbeitungshistorie eines Posts sind
in_reply_to_user_id	Gibt ein User-Objekt zurück, das den Post-Autor repräsentiert, auf den dieser angeforderte Post antwortet
attachments.media_keys	Gibt ein Media-Objekt zurück, das die im Post enthaltenen Bilder, Videos und GIFs repräsentiert
attachments.poll_ids	Gibt ein Poll-Objekt zurück, das Metadaten für die im Post enthaltene Umfrage enthält
geo.place_id	Gibt ein Place-Objekt zurück, das Metadaten für den im Post gekennzeichneten Ort enthält
entities.mentions.username	Gibt ein User-Objekt für den im Post erwähnten Nutzer zurück
referenced_tweets.id.author_id	Gibt ein User-Objekt für den Autor des referenzierten Posts zurück

​

Verfügbare Erweiterungen für Benutzer-Payloads

Expansion	Beschreibung
pinned_tweet_id	Gibt ein Post-Objekt zurück, das den am oberen Rand des Benutzerprofils angehefteten Post repräsentiert

​

Verfügbare Expansions für Direct-Message-Ereignis-Payloads

Expansion	Beschreibung
attachments.media_keys	Gibt ein Media-Objekt zurück, das an eine Direct Message angehängt wurde
referenced_tweets.id	Gibt ein Post-Objekt zurück, das in einer Direct Message referenziert wurde
sender_id	Gibt ein User-Objekt zurück, das den Autor einer Direct Message darstellt und der einen Teilnehmer eingeladen hat, einer Unterhaltung beizutreten
participant_ids	Gibt ein User-Objekt zurück, das einen Teilnehmer darstellt, der einer Unterhaltung beigetreten ist oder sie verlassen hat

​

Verfügbare Expansions für Spaces-Payloads

Expansion	Beschreibung
invited_user_ids	Gibt User-Objekte zurück, die angeben, welche Accounts eingeladen wurden
speaker_ids	Gibt User-Objekte zurück, die angeben, welche Accounts während eines Space gesprochen haben
creator_id	Gibt ein User-Objekt zurück, das angibt, welcher Account den Space erstellt hat
host_ids	Gibt User-Objekte zurück, die angeben, welche Accounts als Hosts festgelegt wurden
topics_ids	Gibt Themenbeschreibungen zurück, die vom Creator festgelegt wurden

​

Verfügbare Erweiterungen für List-Payloads

Expansion	Beschreibung
owner_id	Gibt ein User-Objekt zurück, das das Konto repräsentiert, das die List erstellt und verwaltet

​

Erweiterung des Media-Objekts

In der folgenden Anfrage fordern wir die Erweiterung geo.place_id an, damit sie zusammen mit den standardmäßigen Post fields enthalten ist:

Beispielanfrage

{`curl 'https://api.x.com/2/tweets/:ID?expansions=geo.place_id' --header 'Authorization: Bearer $ACCESS_TOKEN'`}

Beispielantwort

{`{
  "data": {
      "geo": {
          "place_id": "01a9a39529b27f36"
      },
      "id": "ID",
      "text": "Test"
  },
  "includes": {
      "places": [
          {
              "full_name": "Manhattan, NY"
              "id": "01a9a39529b27f36"
          }
      ]
  }
}`}

​

Erweiterung des Poll-Objekts

In der folgenden Anfrage fordern wir die attachments.poll_ids-Erweiterung an, damit sie neben den standardmäßigen Post fields enthalten ist:

Beispielanfrage

Beispielantwort

{`{
  "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 Hashtag“"
                      "votes": 156
                  }
              ]
          }
      ]
  }
}`}

​

Das Place-Objekt erweitern

In der folgenden Anfrage fordern wir die Expansion geo.place_id an, damit sie neben den standardmäßigen Post-Feldern enthalten ist:

Beispielanfrage

Beispielantwort

{`{
  "data": {
      "geo": {
          "place_id": "01a9a39529b27f36"
      },
      "id": "ID",
      "text": "Test"
  },
  "includes": {
      "places": [
          {
              "full_name": "Manhattan, NY"
              "id": "01a9a39529b27f36"
          }
      ]
  }
}`}