Saltar al contenido principal
Los endpoints de Enterprise han sido actualizados para proporcionar metadatos de Posts editados. La funcionalidad Edit Posts fue introducida 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 para Posts creados desde el 29 de septiembre de 2022 incluyen metadatos de edición de Post, 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 necesitan parámetros de solicitud para incluir el historial de edición disponible como parte del objeto Post. Con estos nuevos metadatos, un desarrollador puede determinar:
  • 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 se pueden editar 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 explícitamente una versión anterior específica por ID de Post.
Se han añadido tres nuevos atributos de Post en el nivel raíz:
  • edit_history  - Proporciona todos los ID de Post asociados al historial de edición del Post. El atributo “initial_tweet_id” indica el Post original y el atributo “edit_tweet_ids” es un arreglo que proporciona todos los ID asociados a su historial de edición. Si el Post no se ha editado, este arreglo 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 elegible para edición en el momento de su creación.
“editable”: true La mayoría de los Posts son elegibles. Sin embargo, los siguientes tipos de Posts no son elegibles:
  • El Post está promocionado
  • El Post incluye una encuesta
  • Post es una respuesta que no pertenece al propio hilo
  • Post es un Retweet (ten en cuenta que los Quote Tweets se pueden editar)
  • Post es nullcast
  • Post de la Comunidad
  • Post de Superfollow
  • Post colaborativo
Atributos de ejemplo para 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 añadió la función de editar Posts. Este ejemplo es para 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 añadió la función de editar Posts. Este ejemplo es para un Post que ha sido editado una vez. Ten en cuenta que el array "edit_tweet_ids" tiene dos id, 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 edición",
  "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 El Compliance Firehose y el endpoint de cumplimiento por lotes de v2 se han actualizado para incorporar 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>"
  }
}
⌘I