Vai al contenuto principale
Gli endpoint Enterprise sono stati aggiornati per fornire metadata dei Post modificati. La funzionalità Edit Posts è stata introdotta per la prima volta per i test tra i dipendenti di X il 1° settembre 2022. A partire da quella data, i Post idonei erano modificabili per 30 minuti e fino a 5 volte. Tutti gli oggetti per i Post creati dal 29 settembre 2022 includono metadata di modifica del Post, anche se il Post non è mai stato modificato. Ogni volta che un Post viene modificato, viene creato un nuovo ID del Post. La cronologia delle modifiche di un Post può essere descritta concatenando questi ID insieme, iniziando dall’ID originale. Inoltre, se qualsiasi Post nella catena di modifiche viene eliminato, tutti i Post in quella catena vengono eliminati di conseguenza. Questi dettagli di metadata sono inclusi automaticamente. Non sono necessari parametri di richiesta per includere la cronologia delle modifiche disponibile come parte dell’Oggetto Post. Con questi nuovi metadata, uno sviluppatore può determinare:
  • Se un Post era modificabile al momento della creazione. Alcuni Post, come quelli con sondaggi o i Post programmati, non possono essere modificati.
  • I Post sono modificabili per 30 minuti e possono essere modificati fino a 5 volte. Per i Post modificabili, puoi vedere se è rimasto tempo per modificarli e quante altre modifiche sono ancora possibili.
  • Se stai visualizzando una versione modificata di un Post. Nella maggior parte dei casi, l’API restituirà la versione più recente di un Post, a meno che non venga richiesta una versione precedente specifica tramite ID del Post.
Tre nuovi attributi Post sono stati aggiunti al livello root:
  • edit_history  - Fornisce tutti gli ID del Post associati alla cronologia delle modifiche del Post. L’attributo “initial_tweet_id” indica il Post originale e l’attributo “edit_tweet_ids” è un array che elenca tutti gli ID associati alla sua cronologia delle modifiche. Se il Post non è stato modificato, questo array conterrà un solo ID.
"edit_history": {
    "initial_tweet_id": "1283764123"
    "edit_tweet_ids": ["1283764123"]
  }
  • edit_controls - Fornisce attributi che indicano quando termina la finestra di modifica di 30 minuti e quante modifiche potenziali restano.
"edit_controls": {  
     "editable\_until\_ms": 1660155761384
     "edits_remaining": 3   
  }
  • editable - Indica se un Post era modificabile al momento della creazione.
“editable”: true La maggior parte dei Post è idonea. Tuttavia, i seguenti tipi di Post non lo sono:
  • Il Post è sponsorizzato
  • Il Post contiene un sondaggio
  • Post è una risposta non in thread con se stesso
  • Il Post è un Retweet (nota che i Quote Tweets sono modificabili)
  • Il Post è un nullcast
  • Post della Community
  • Post Super Follow
  • Post collaborativo
Attributi di esempio per Post non modificato Il JSON seguente evidenzia i metadata di modifica inclusi per un Post pubblicato dopo l’introduzione della funzionalità di modifica dei Post. Questo esempio si riferisce a un Post senza cronologia di modifiche. Nota che l’array "edit_tweet_ids" contiene un singolo ID. 
{
  "created_at": "Wed Aug 16 18:29:02 +0000 2022",
  "id": 1557433858676740098,
  "id_str": "1557433858676740098",
  "text": "Mi chiedo se userò mai il pulsante di modifica",
  "edit_history": {
    "initial_tweet_id": "1557433858676740098",
    "edit_tweet_ids": ["1557433858676740098"]
  },
  "edit_controls": {
    "editable_until_ms": 1660155761384,
    "edits_remaining": 5
  },
  "editable": true
}
Attributi di esempio per un Post modificato Il JSON qui sotto evidenzia i metadata di modifica inclusi per un post pubblicato dopo l’aggiunta della funzionalità di modifica Post. Questo esempio si riferisce a un Post che è stato modificato una sola volta. Nota che l’array "edit_tweet_ids" contiene due ID, uno per il Post originale e uno per l’aggiornamento modificato. 
{
  "created_at": "Wed Aug 16 18:35:42 +0000 2022",
  "id": 1557445923210514432,
  "id_str": "1557445923210514432",
  "text": "Chissà se userò mai il pulsante di modifica",
  "edit_history": {
    "initial_tweet_id": "1557433858676740098",
    "edit_tweet_ids": ["1557433858676740098", "1557445923210514432"]
  },
  "edit_controls": {
    "editable_until_ms": 1660155761384,
    "edits_remaining": 4
  },
  "editable": true
}
Supporto alla conformità Il Compliance Firehose e l’endpoint di conformità batch v2 sono stati entrambi aggiornati per supportare la modifica dei Post: Nel Compliance Firehose è stato aggiunto un nuovo tipo di evento “tweet_edit”. 
{
  "tweet_edit": {
    "id": <tweetId>,
    "initial_tweet_id": <tweetId>,
    "edit_tweet_ids": [<tweetId1>, <tweetId2>, <tweetId3> ...],
    "timestamp_ms": "<timestampMsStr>"
  }
}
⌘I