Zum Hauptinhalt springen
Enterprise-Endpoints wurden aktualisiert, um bearbeitete Post-Metadaten bereitzustellen. Die Edit Posts-Funktion wurde erstmals am 1. September 2022 zum Testen unter X-Mitarbeitern eingeführt. Ab diesem Datum waren berechtigte Posts 30 Minuten lang und bis zu 5 Mal bearbeitbar. Alle Objekte für Posts, die seit dem 29. September 2022 erstellt wurden, enthalten Post-Bearbeitungsmetadaten, auch wenn der Post nie bearbeitet wurde. Jedes Mal, wenn ein Post bearbeitet wird, wird eine neue Post-ID erstellt. Der Bearbeitungsverlauf eines Posts kann durch die Verkettung dieser IDs beschrieben werden, beginnend mit der ursprünglichen ID. Zusätzlich werden, wenn ein Post in der Bearbeitungskette gelöscht wird, alle Posts in dieser Kette ebenfalls gelöscht. Diese Metadaten-Details sind automatisch enthalten. Es sind keine Anfrageparameter erforderlich, um die verfügbare Bearbeitungshistorie als Teil des Post-Objekts einzuschließen. Mit diesen neuen Metadaten kann ein Entwickler herausfinden:
  • Wenn ein Post zum Zeitpunkt der Erstellung bearbeitbar war. Einige Posts, etwa solche mit Umfragen oder geplante Posts, können nicht bearbeitet werden.
  • Posts sind 30 Minuten lang bearbeitbar und können bis zu 5-mal geändert werden. Bei bearbeitbaren Posts sehen Sie, ob noch Zeit zum Bearbeiten verbleibt und wie viele weitere Änderungen möglich sind.
  • Wenn Sie eine bearbeitete Version eines Posts anzeigen, gibt die API in den meisten Fällen die jüngste Version eines Posts zurück, es sei denn, eine bestimmte frühere Version wird über die Post-ID angefordert.
Drei neue Post-Attribute wurden auf der Stammebene hinzugefügt:
  • edit_history  - Liefert alle Post-IDs, die der Bearbeitungshistorie des Posts zugeordnet sind. Das Attribut “initial_tweet_id” kennzeichnet den ursprünglichen Post, und das Attribut “edit_tweet_ids” ist ein Array, das alle IDs enthält, die seiner Bearbeitungshistorie zugeordnet sind. Wenn der Post nicht bearbeitet wurde, enthält dieses Array eine einzelne ID.
"edit_history": {
    "initial\_tweet\_id": "1283764123"
    "edit\_tweet\_ids": \["1283764123"\]
  }
  • edit_controls - Enthält Attribute, die angeben, wann das 30‑minütige Bearbeitungsfenster endet und wie viele mögliche Bearbeitungen noch verbleiben.
"edit_controls": {  
     "editable\_until\_ms": 1660155761384
     "edits_remaining": 3   
  }
  • editable - Gibt an, ob ein Post zum Zeitpunkt der Erstellung bearbeitet werden konnte.
„editable”: true Die meisten Posts sind geeignet. Die folgenden Arten von Posts sind jedoch nicht geeignet:
  • Post wird hervorgehoben
  • Post enthält eine Umfrage
  • Post ist eine Antwort, die nicht zum eigenen Thread gehört
  • Post ist ein Retweet (beachte, dass Quote Tweets bearbeitet werden können)
  • Post ist nullgecastet
  • Community-Post
  • Superfollow-Post
  • Gemeinsamer Post
Beispielattribute für unbearbeiteten Post Das JSON unten zeigt die Bearbeitungs-Metadata, die für einen Post enthalten ist, der nach der Einführung der Post-Bearbeitungsfunktion veröffentlicht wurde. Dieses Beispiel zeigt einen Post ohne Bearbeitungsverlauf. Beachten Sie, dass das "edit_tweet_ids"-Array eine einzelne ID hat. 
{
  "created_at": "Wed Aug 16 18:29:02 +0000 2022",
  "id": 1557433858676740098,
  "id_str": "1557433858676740098",
  "text": "Ich frage mich, ob ich jemals die Bearbeiten-Schaltfläche verwenden werde",
  "edit_history": {
    "initial_tweet_id": "1557433858676740098",
    "edit_tweet_ids": ["1557433858676740098"]
  },
  "edit_controls": {
    "editable_until_ms": 1660155761384,
    "edits_remaining": 5
  },
  "editable": true
}
Beispielattribute für einen bearbeiteten Post Das JSON unten zeigt die Bearbeitungs-metadata, die für einen Post enthalten ist, der nach dem Hinzufügen der Post-Bearbeitungsfunktion veröffentlicht wurde. Dieses Beispiel zeigt einen Post, der einmal bearbeitet wurde. Beachten Sie, dass das "edit_tweet_ids"-Array zwei IDs enthält, eine für den ursprünglichen Post und eine für die bearbeitete Version. 
{
  "created_at": "Wed Aug 16 18:35:42 +0000 2022",
  "id": 1557445923210514432,
  "id_str": "1557445923210514432",
  "text": "Ich frage mich, ob ich jemals den Bearbeiten-Button verwenden werde",
  "edit_history": {
    "initial_tweet_id": "1557433858676740098",
    "edit_tweet_ids": ["1557433858676740098", "1557445923210514432"]
  },
  "edit_controls": {
    "editable_until_ms": 1660155761384,
    "edits_remaining": 4
  },
  "editable": true
}
Compliance-Support Die Compliance Firehose und der v2-Batch-Compliance-endpoint wurden beide aktualisiert, um die Bearbeitung von Posts zu unterstützen: Der Compliance Firehose wurde ein neuer Ereignistyp „tweet_edit“ hinzugefügt. 
{
  "tweet_edit": {
    "id": <tweetId>,
    "initial_tweet_id": <tweetId>,
    "edit_tweet_ids": [<tweetId1>, <tweetId2>, <tweetId3> ...],
    "timestamp_ms": "<timestampMsStr>"
  }
}
⌘I