Passer au contenu principal
Les endpoints Enterprise ont été mis à jour pour fournir les metadata des Posts modifiés. La fonctionnalité Edit Posts a été introduite pour la première fois pour des tests parmi les employés de X le 1er septembre 2022. À partir de cette date, les Posts éligibles étaient modifiables pendant 30 minutes et jusqu’à 5 fois. Tous les objets pour les Posts créés depuis le 29 septembre 2022 incluent les metadata de modification de Post, même si le Post n’a jamais été modifié. Chaque fois qu’un Post est modifié, un nouvel ID de Post est créé. L’historique de modification d’un Post peut être décrit en chaînant ces ID ensemble, en commençant par l’ID original. De plus, si un Post dans la chaîne de modification est supprimé, tous les Posts de cette chaîne sont également supprimés. Ces détails de metadata sont inclus automatiquement. Aucun paramètre de requête n’est nécessaire pour inclure l’historique de modification disponible dans l’objet Post. Avec ces nouvelles métadonnées, un développeur peut découvrir :
  • Si un Post était modifiable au moment de sa création. Certains Posts, comme ceux comportant des sondages ou des Posts programmés, ne peuvent pas être modifiés.
  • Les Posts sont modifiables pendant 30 minutes et peuvent être modifiés jusqu’à 5 fois. Pour les Posts modifiables, vous pouvez voir s’il reste du temps pour les modifier et combien d’autres modifications sont possibles.
  • Si vous consultez une version modifiée d’un Post. Dans la plupart des cas, l’API renverra la version la plus récente d’un Post, sauf si une version antérieure précise est demandée via l’ID de Post.
Trois nouveaux attributs Post ont été ajoutés au niveau racine :
  • edit_history  - Fournit tous les ID de Post associés à l’historique de modification du Post. L’attribut “initial_tweet_id” indique le Post d’origine et l’attribut “edit_tweet_ids” est un tableau qui fournit tous les ID associés à son historique de modification. Si le Post n’a pas été modifié, ce tableau contiendra un seul ID.
"edit_history": {
    "initial\_tweet\_id": "1283764123"
    "edit\_tweet\_ids": \["1283764123"\]
  }
  • edit_controls - Fournit des attributs indiquant quand la fenêtre d’édition de 30 minutes prend fin et combien de modifications potentielles restent.
"edit_controls": {  
     "editable\_until\_ms": 1660155761384
     "edits_remaining": 3   
  }
  • editable - Indique si un Post était modifiable au moment de sa création.
“editable”: true La plupart des Posts sont éligibles. Cependant, les types de Posts suivants ne le sont pas :
  • Le Post est sponsorisé
  • Le Post comporte un sondage
  • Post est une réponse qui n’appartient pas à son propre fil
  • Le Post est un Retweet (notez que les Quote Tweets peuvent être modifiés)
  • Le Post est en nullcast
  • Post de la communauté
  • Post Super Follow
  • Post collaboratif
Exemples d’attributs pour un Post non modifié Le JSON ci-dessous met en évidence les metadata d’édition qui sont incluses pour un Post publié après l’ajout de la fonctionnalité de modification de Post. Cet exemple concerne un Post qui n’a aucun historique de modification. Notez que le tableau "edit_tweet_ids" ne contient qu’un seul id. 
{
  "created_at": "Wed Aug 16 18:29:02 +0000 2022",
  "id": 1557433858676740098,
  "id_str": "1557433858676740098",
  "text": "Je me demande si j'utiliserai un jour le bouton de modification",
  "edit_history": {
    "initial_tweet_id": "1557433858676740098",
    "edit_tweet_ids": ["1557433858676740098"]
  },
  "edit_controls": {
    "editable_until_ms": 1660155761384,
    "edits_remaining": 5
  },
  "editable": true
}
Exemples d’attributs pour un Post modifié Le JSON ci-dessous met en évidence les metadata d’édition qui sont incluses pour un Post publié après l’ajout de la fonctionnalité d’édition de Post. Cet exemple concerne un Post qui a été modifié une seule fois. Notez que le tableau "edit_tweet_ids" contient deux id, un pour le Post original et un pour la mise à jour modifiée. 
{
  "created_at": "Wed Aug 16 18:35:42 +0000 2022",
  "id": 1557445923210514432,
  "id_str": "1557445923210514432",
  "text": "Je me demande si j'utiliserai un jour le bouton d'édition",
  "edit_history": {
    "initial_tweet_id": "1557433858676740098",
    "edit_tweet_ids": ["1557433858676740098", "1557445923210514432"]
  },
  "edit_controls": {
    "editable_until_ms": 1660155761384,
    "edits_remaining": 4
  },
  "editable": true
}
Support de conformité Le Compliance Firehose et l’endpoint de conformité par lots v2 batch compliance endpoint ont tous deux été mis à jour pour prendre en charge l’édition de Post : Un nouveau type d’événement « tweet_edit » a été ajouté au Compliance Firehose. 
{
  "tweet_edit": {
    "id": <tweetId>,
    "initial_tweet_id": <tweetId>,
    "edit_tweet_ids": [<tweetId1>, <tweetId2>, <tweetId3> ...],
    "timestamp_ms": "<timestampMsStr>"
  }
}
⌘I