Editar Tweets

Os endpoints Enterprise foram atualizados para fornecer metadata de Posts editados. O recurso Edit Posts foi introduzido pela primeira vez para testes entre funcionários do X em 1º de setembro de 2022. A partir dessa data, Posts elegíveis eram editáveis por 30 minutos e até 5 vezes. Todos os objetos para Posts criados desde 29 de setembro de 2022 incluem metadata de edição de Post, mesmo que o Post nunca tenha sido editado. Cada vez que um Post é editado, um novo ID do Post é criado. O histórico de edição de um Post pode ser descrito encadeando esses IDs, começando com o ID original. Além disso, se qualquer Post na cadeia de edição for excluído, todos os Posts nessa cadeia também são excluídos.

Esses detalhes de metadata são incluídos automaticamente. Nenhum parâmetro de requisição é necessário para incluir o histórico de edição disponível como parte do Objeto Post.

Com esses novos metadados, um desenvolvedor pode descobrir:

• Se um Post era elegível para edição no momento da criação. Alguns Posts, como aqueles com enquetes ou Posts agendados, não podem ser editados.
• Posts podem ser editados por 30 minutos e até 5 vezes. Em Posts editáveis, você pode verificar se ainda há tempo para editar e quantas edições restantes são possíveis.
• Se você estiver visualizando uma versão editada de um Post. Na maioria dos casos, a API retornará a versão mais recente de um Post, a menos que uma versão anterior específica seja solicitada pelo ID do Post.

Três novos atributos de Post foram adicionados no nível raiz:

• edit_history  - Fornece todos os IDs do Post associados ao histórico de edições do Post. O atributo “initial_tweet_id” indica o Post original e o atributo “edit_tweet_ids” é uma matriz que fornece todos os IDs associados ao seu histórico de edições. Se o Post não tiver sido editado, essa matriz conterá um único ID.

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

• edit_controls - Fornece atributos que indicam quando a janela de edição de 30 minutos se encerra e quantas edições possíveis ainda restam.

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

• editable - Indica se um Post era elegível para edição no momento da criação.

“editable”: true

A maioria dos Posts é elegível. No entanto, os seguintes tipos de Posts não são:

• Post promovido
• O Post tem uma enquete
• Post é uma resposta que não inicia um encadeamento próprio
• Post é um Retweet (observe que Posts com citação são elegíveis para edição)
• Post é nullcast
• Post da Comunidade
• Post de Super Follow
• Post colaborativo

Atributos de exemplo para Post não editado

O JSON abaixo destaca os metadata de edição que são incluídos para um Post publicado após a funcionalidade de edição de Posts ter sido adicionada. Este exemplo é para um Post que não possui histórico de edição.

Observe que o array "edit_tweet_ids" tem um único ID.

{
  "created_at": "Wed Aug 16 18:29:02 +0000 2022",
  "id": 1557433858676740098,
  "id_str": "1557433858676740098",
  "text": "Será que um dia vou usar o botão 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 exemplo para um Post editado

O JSON abaixo destaca os metadata de edição que são incluídos para um Post publicado após a funcionalidade de edição de Posts ter sido adicionada. Este exemplo é para um Post que teve uma única edição.

Observe que o array "edit_tweet_ids" possui dois IDs, um para o Post original e outro para a atualização editada.

{
  "created_at": "Wed Aug 16 18:35:42 +0000 2022",
  "id": 1557445923210514432,
  "id_str": "1557445923210514432",
  "text": "Será que um dia vou usar o botão de editar",
  "edit_history": {
    "initial_tweet_id": "1557433858676740098",
    "edit_tweet_ids": ["1557433858676740098", "1557445923210514432"]
  },
  "edit_controls": {
    "editable_until_ms": 1660155761384,
    "edits_remaining": 4
  },
  "editable": true
}

Suporte à conformidade

O Compliance Firehose e o endpoint de conformidade em lote da v2 foram atualizados para oferecer suporte à edição de Posts:

Um novo tipo de evento “tweet_edit” foi adicionado ao Compliance Firehose.

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