Editar Tweets

Los endpoints empresariales se han actualizado para proporcionar metadatos de Posts editados. La funcionalidad Editar Posts se introdujo por primera vez para pruebas entre empleados de X el 1 de septiembre de 2022. A partir de esa fecha, los Posts elegibles podían editarse durante 30 minutos y hasta 5 veces. Todos los objetos de Posts creados desde el 29 de septiembre de 2022 incluyen metadatos de edición de Posts, incluso si el Post nunca fue editado. Cada vez que se edita un Post, se crea un nuevo ID de Post. El historial de edición de un Post puede describirse encadenando estos IDs, comenzando con el ID original. Además, si se elimina cualquier Post en la cadena de edición, todos los Posts de esa cadena también se eliminan.

Estos detalles de metadatos se incluyen automáticamente. No se requieren parámetros de solicitud para incluir el historial de edición disponible como parte del objeto Post.

Con estos nuevos metadatos, un desarrollador puede conocer:

• Si un Post era apto para edición en el momento de su creación. Algunos Posts, como los que incluyen encuestas o los programados, no se pueden editar.
• Los Posts pueden editarse durante 30 minutos y hasta 5 veces. En los Posts editables, puedes ver si aún queda tiempo para editar y cuántas ediciones más son posibles.
• Si estás viendo una versión editada de un Post. En la mayoría de los casos, la API devolverá la versión más reciente de un Post, a menos que se solicite una versión anterior específica por id del Post.

Se han agregado tres nuevos atributos de Post en el nivel raíz:

• edit_history  - Proporciona todos los ID de Post asociados con el historial de edición del Post. El atributo “initial_tweet_id” indica el Post original y el atributo “edit_tweet_ids” es una matriz que proporciona todos los ID asociados con su historial de edición. Si el Post no ha sido editado, esta matriz contendrá un único ID.

"edit_history": {
    "initial\_tweet\_id": "1283764123"
    "edit\_tweet\_ids": \["1283764123"\]
  }

• edit_controls - Proporciona atributos que indican cuándo finaliza la ventana de edición de 30 minutos y cuántas ediciones potenciales quedan.

"edit_controls": {  
     "editable\_until\_ms": 1660155761384
     "edits_remaining": 3   
  }

• editable - Indica si un Post era apto para edición al momento de su creación.

“editable”: true

La mayoría de los Posts son elegibles. Sin embargo, los siguientes tipos de Posts no lo son:

• El Post está promocionado
• La publicación incluye una encuesta
• El Post es una respuesta que no pertenece a su propio hilo
• El Post es un Retweet (ten en cuenta que los Quote Tweets se pueden editar)
• El Post es de alcance nulo
• Publicación de la comunidad
• Post de Super Follow
• Post colaborativo

Atributos de ejemplo para un Post sin editar

El JSON a continuación resalta los metadatos de edición que se incluyen para un Post publicado después de que se agregó la función de edición de Posts. Este ejemplo corresponde a un Post que no tiene historial de edición.

Ten en cuenta que el array "edit_tweet_ids" tiene un solo ID.

{
  "created_at": "Wed Aug 16 18:29:02 +0000 2022",
  "id": 1557433858676740098,
  "id_str": "1557433858676740098",
  "text": "Me pregunto si alguna vez usaré el botón de editar",
  "edit_history": {
    "initial_tweet_id": "1557433858676740098",
    "edit_tweet_ids": ["1557433858676740098"]
  },
  "edit_controls": {
    "editable_until_ms": 1660155761384,
    "edits_remaining": 5
  },
  "editable": true
}

Atributos de ejemplo para un Post editado

El JSON a continuación resalta los metadatos de edición que se incluyen para un Post publicado después de que se agregó la función de edición de Posts. Este ejemplo corresponde a un Post que ha sido editado una vez.

Ten en cuenta que el array "edit_tweet_ids" tiene dos IDs: uno para el Post original y otro para la actualización editada.

{
  "created_at": "Wed Aug 16 18:35:42 +0000 2022",
  "id": 1557445923210514432,
  "id_str": "1557445923210514432",
  "text": "Me pregunto si alguna vez usaré el botón de editar",
  "edit_history": {
    "initial_tweet_id": "1557433858676740098",
    "edit_tweet_ids": ["1557433858676740098", "1557445923210514432"]
  },
  "edit_controls": {
    "editable_until_ms": 1660155761384,
    "edits_remaining": 4
  },
  "editable": true
}

Soporte de cumplimiento normativo

El Compliance Firehose y el endpoint de cumplimiento por lotes de la v2 se han actualizado para ofrecer compatibilidad con la edición de Posts: 

Se ha añadido un nuevo tipo de evento “tweet_edit” al Compliance Firehose.

{
  "tweet_edit": {
    "id": <tweetId>,
    "initial_tweet_id": <tweetId>,
    "edit_tweet_ids": [<tweetId1>, <tweetId2>, <tweetId3> ...],
    "timestamp_ms": "<timestampMsStr>"
  }
}