Migration du format des données

​

Introduction

Avec le lancement de la version v2 de la X API, nous avons adopté un nouveau format de réponse de données et une nouvelle méthode pour demander différents objets et champs, que nous appelons simplement le format X API v2. 

Dans la section sur les différences générales, vous pouvez découvrir certains changements pertinents pour les utilisateurs standard et entreprise. Cependant, nous avons également préparé un guide spécifique pour le format natif standard v1.1, le format Native Enriched pour l’entreprise et le format Activity Streams pour l’entreprise, qui aide à établir la correspondance entre les champs et explique quels champs et expansions vous devez utiliser pour récupérer les nouveaux champs v2. 

• Format natif vers X API v2 (standard v1.1) 
• Native Enriched vers X API v2 (enterprise)
• Activity Streams vers X API v2 (enterprise)

Vous serez peut‑être également intéressé par notre outil visuel de migration de format de données, qui vous aide à voir rapidement les différences entre le format de données X API v1.1 et le format X API v2.

​

Différences générales

​

Requête d’objets et de champs

L’une des plus grandes différences entre les endpoints antérieurs à la v2 et la v2 est que la nouvelle version ne renvoie que quelques champs par défaut, alors que les endpoints Standard, Premium et Enterprise renvoient la plupart des champs par défaut. La nouvelle version utilise des paramètres appelés fields et expansions pour demander explicitement des données supplémentaires au‑delà des valeurs par défaut, ce qui signifie que vous pouvez demander uniquement les données dont vous avez besoin sans avoir à ingérer des champs qui ne vous intéressent pas. 

Tous les champs que vous demandez et qui concernent l’objet de données principal seront renvoyés dans cet objet principal, en plus des valeurs par défaut. Toutefois, si vous demandez des objets étendus à l’aide du paramètre expansions, les objets secondaires seront renvoyés dans un nouvel objet includes. Vous pouvez faire correspondre les objets étendus dans l’objet includes à l’objet principal en utilisant le champ id, qui sera renvoyé dans les deux.

Par exemple, si vous utilisez l’endpoint v2 Post lookup et que vous incluez le paramètre expansions=author_id dans votre requête, vous recevrez le champ author_id dans l’objet Publication principal, ainsi qu’un objet user par Publication dans l’objet includes, chacun incluant le champ par défaut id qui peut être utilisé pour faire correspondre l’objet user à l’objet Publication. Voici un exemple du résultat :

{
  "data": [
    {
      "author_id": "2244994945",
      "id": "1397568983931392004",
      "text": "The Twitter Developer Platform. Ooh la la! https://t.co/iGTdPXBfOv https://t.co/Ze8z8EODdg"
    }
  ],
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "name": "Twitter Dev",
        "username": "TwitterDev"
      }
    ]
  }
}

​

Conception JSON mise à jour

En plus des changements concernant la façon de demander certains champs, X API v2 introduit également de nouvelles conceptions JSON pour les objets renvoyés par les API, y compris les objets Publication et utilisateur.

• Au niveau racine du JSON, les endpoints standard renvoient les objets Publication dans un tableau statuses, tandis que X API v2 renvoie un tableau data. 
• Au lieu de faire référence à des « statuses » retweetés et cités, le JSON de X API v2 fait référence à des Tweets retweetés et cités. De nombreux champs hérités et obsolètes, tels que contributors et user.translator_type, sont supprimés. 
• Au lieu d’utiliser à la fois favorites (dans l’objet Publication) et favourites (dans l’objet utilisateur), X API v2 utilise le terme like. 
• X adopte la convention selon laquelle les valeurs JSON vides (par exemple, null) ne sont pas écrites dans la charge utile. Les attributs de Publication et d’utilisateur ne sont inclus que s’ils ont des valeurs non nulles.   

​

Nouveaux champs v2

Nous avons également introduit un nouvel ensemble de champs pour l’objet Publication, comprenant les éléments suivants :

• Un champ conversation_id
• Deux nouveaux champs annotations, dont context et entities
• Plusieurs nouveaux champs metrics
• Un nouveau champ reply_setting, qui indique qui est autorisé à répondre à une Publication donnée

​

Migration du format de données standard v1.1 vers v2

Si ce n’est pas déjà fait, nous vous recommandons de commencer par lire l’introduction à la migration des formats de données. Vous pouvez également être intéressé par notre outil visuel de migration de format de données, qui vous aide à visualiser rapidement les différences entre le format de données X API v1.1 et le format X API v2.

Le format de données standard v1.1, également appelé format natif, est le format principal fourni avec les endpoints standard v1.1.

Si vous utilisez le produit Premium, veuillez vous référer au guide sur le format natif enrichi. Les clients Enterprise peuvent utiliser soit le format natif enrichi, soit les flux d’activité, en fonction de leur configuration dans la console Gnip. 

​

Structure de payload standard v1.1 vs v2

Le tableau suivant présente les objets de haut niveau et le format auxquels vous pouvez vous attendre avec la v2 par rapport au format v1.1.

	Structure v1.1	Structure v2
Par défaut	{ all tweet object fields, “entities”: { “hashtags”: [], “symbols”: [], “user_mentions”: [], “urls”: [], “media”: [] }, “extended_entities”: , “user”: , “place”: , “retweeted_status/quoted_status” }	{ “data”: [{ “id”, “text”, “edit_history_tweet_ids” }] }
Avec des paramètres champs et expansions définis		{ “data”: [{ tweet object fields, “entities”: { “hashtags”: [], “cashtags”: [], “mentions”: [], “urls”: [], }, “attachments”: { “media_keys”: [], “poll_ids”: [] } }], “includes”: [ “tweets”: [tweet objects], “users”: [user objects], “media”: [media objects], “places”: [place object], “polls”: [poll object] ], “matching_rules”: [] }

Correspondance des champs

La section suivante décrit quels champs v1.1 se correspondent avec les champs v2, ainsi que les paramètres v2 requis pour recevoir le nouveau champ.  

​

Objet Tweet

Format Twitter 1.1	Format Twitter v2	Paramètres v2 requis
created_at	data.created_at	tweet.fields=created_at
id		N/A l’id est une chaîne de caractères
id_str	data.id	par défaut
text	data.text	par défaut
full_text		N/A text inclut le texte complet
truncated		N/A text inclut le texte complet
display_text_range		N/A text inclut le texte complet
edit_history	data.edit_history_tweet_ids	par défaut
edit_controls	data.edit_controls	tweet.fields=edit_controls
editable	data.edit_controls.is_edit_eligible	tweet.fields=edit_controls
entities	data.entities	tweet.fields=entities
entities.user_mentions	data.entities.mentions	tweet.fields=entities
entities.symbols	data.entities.cashtags	tweet.fields=entities
entities.hashtags	data.entities.hashtags	tweet.fields=entities
entities.urls	data.entities.urls	tweet.fields=entities
entities.media	includes.media	expansions=attachments.media_keys
extended_entities	data.attachments	tweet_fields=attachments
in_reply_to_status_id		N/A referenced_tweets.id est une chaîne de caractères
in_reply_to_status_id_str	data.referenced_tweets.id (si type=replied_to)	expansions=referenced_tweets.id
in_reply_to_user_id		N/A in_reply_to_user_id est une chaîne de caractères
in_reply_to_user_id_str	data.in_reply_to_user_id	tweet.fields=in_reply_to_user_id
in_reply_to_screen_name	includes.users..username	tweet.fields=in_reply_to_user_id&expansions=entities.mentions.username
user	includes.users	expansions=author_id
geo	data.geo.place_id	tweet.fields=geo
coordinates	data.geo.place_id	expansions=geo.place_id
place	data.geo.place_id	expansions=geo.place_id
retweeted_status	data.referenced_tweets.id (si type=retweeted)	expansions=referenced_tweets.id
is_quoted_status		Non disponible
quoted_status_id		N/A referenced_tweets.id est une chaîne de caractères
quoted_status_id_str	data.referenced_tweets.id (si type=quoted)	expansions=referenced_tweets.id
quoted_status_permalink		Non disponible
quoted_status	data.referenced_tweets (si type=quoted)	expansions=referenced_tweets.id
retweet_count	data.public_metrics.retweet_count	tweet.fields=public_metrics
favorite_count	data.public_metrics.like_count	tweet.fields=public_metrics
favorited		Non disponible
retweeted		Non disponible
possibly_sensitive	data.possibly_sensitive	tweet.fields=possibly_sensitive
lang	data.lang	tweet.fields=lang
scopes		Non disponible
withheld	data.withheld	tweet.fields=withheld

Exemple

Objet Tweet dans v1.1 Exemple d’URI avec paramètres : https://api.x.com/1.1/statuses/lookup.json?id=1359554366051504129&tweet_mode=extended	Objet Tweet et requête dans v2 Exemple d’URI avec paramètres : https://api.x.com/2/tweets?ids=1359554366051504129&tweet.fields=attachments,author_id,context_annotations,conversation_id,created_at,entities,geo,id,in_reply_to_user_id,lang,possibly_sensitive,public_metrics,referenced_tweets,reply_settings,text,withheld
{ “created_at”: “Wed Feb 10 17:26:34 +0000 2021”, “id”: 1359554366051504129, “id_str”: “1359554366051504129”, “text”: “N’hésitez pas, suivez un autre compte consacré aux chiots. On ne vous jugera pas. \n\nPrésentation des endpoints de gestion des abonnements dans la nouvelle… https://t.co/3cBZKZUevF”, “truncated”: true, “entities”: { “hashtags”: [], “symbols”: [], “user_mentions”: [], “urls”: [{ “url”: “https://t.co/3cBZKZUevF”, “expanded_url”: “https://twitter.com/i/web/status/1359554366051504129”, “display_url”: “twitter.com/i/web/status/1…”, “indices”: [ 111, 134 ] }] }, “in_reply_to_status_id”: null, “in_reply_to_status_id_str”: null, “in_reply_to_user_id”: null, “in_reply_to_user_id_str”: null, “in_reply_to_screen_name”: null, “user”: { … }, “geo”: null, “coordinates”: null, “place”: null, “contributors”: null, “is_quote_status”: false, “retweet_count”: 18, “favorite_count”: 98, “favorited”: false, “retweeted”: false, “possibly_sensitive”: false, “possibly_sensitive_appealable”: false, “lang”: “en” }	{ “data”: [{ “id”:“1359554366051504129”, “texte”:“Allez-y, suivez un autre compte de chiots. On ne vous jugera pas. \n\nPrésentation des endpoints de gestion des abonnements pour la nouvelle #TwitterAPI. Vous pouvez désormais utiliser l’API v2 pour suivre et ne plus suivre des comptes. En savoir plus https://t.co/mtpd9VIMDa”, “lang”:“fr”, “conversation_id”:“1359554366051504129”, “possibly_sensible”: false, “reply_paramètres”:“everyone”, “created_at”:“2021-02-10T17:26:34.000Z”, “auteur_id”:“2244994945”, “public_metrics”:{ “retweet_count”: 18, “reply_count”: 11, “like_count”: 98, “quote_count”: 7 }, “entities”:{ “hashtags”: [{ “démarrer”: 110, “fin”: 121, “tag”:“TwitterAPI” }], “urls”: [{ “démarrer”: 194, “fin”: 217, “url”:“https://t.co/mtpd9VIMDa”, “étendue_url”:“https://devcommunity.x.com/t/introducing-the-new-manage-follows-endpoints-to-the-twitter-api-v2/149465”, “display_url”:“devcommunity.com/t/introducing-…”, “images”: [{ “url”:“https://pbs.twimg.com/news_img/1359554367905427457/DczC72__?format=jpg&name=orig”, “width”: 1200, “height”: 630 }, { “url”:“https://pbs.twimg.com/news_img/1359554367905427457/DczC72__?format=jpg&name=150x150”, “width”: 150, “height”: 150 } ], “status”: 200, “title”:“Présentation des nouveaux points de terminaison de gestion des abonnements de X API v2”, “description”:“Suivre ou ne pas suivre ? Vous êtes désormais libre de répondre à cette question comme bon vous semble en utilisant X API v2. Aujourd’hui, nous sommes ravis d’annoncer la sortie des nouveaux endpoints de gestion des abonnements dans la nouvelle Twitter API. Comme annoncé lors du lancement des endpoints de consultation des abonnements il y a un peu plus d’un mois, la possibilité de gérer les relations d’abonnement est enfin là. Il s’agit de certains de nos endpoints les plus populaires sur nos API v1.1, nous sommes donc ravis de débloquer un large éventail de cas d’usage sur X API v2. N…”, “déroulé_url”:“https://devcommunity.x.com/t/introducing-the-new-manage-follows-endpoints-to-the-twitter-api-v2/149465” }] }, “contexte_annotations”: [{ “domain”:{ “id”:“46”, “name”:“Catégorie de marque”, “description”:“Catégories au sein des verticales de marque qui précisent le périmètre des marques” }, “entity”:{ “id”:“781974596752842752”, “name”:“Services” } }, { “domain”:{ “id”:“47”, “name”:“Marque”, “description”:“Marques et sociétés” }, “entity”:{ “id”:“10045225402”, “name”:“Twitter” } } ] }] }

---

​

Objet User

Format Twitter 1.1	Format Twitter v2	Paramètres v2 requis
user_id	data.author_id	tweet.fields=author_id
user.id		N/A : utilisez includes.users.id
user.id_str	includes.users.id	expansions=author_id
user.name	includes.users.name	expansions=author_id
user.screen_name	includes.user.username	expansions=author_id
user.location	includes.users.location	expansions=author_id&user.fields=location
user.description	includes.users.description	expansions=author_id&user.fields=description
user.url	includes.users.url	expansions=author_id&user.fields=entities
user.entities	includes.users.entities
user.entities.url.urls.url	includes.users.entities.url.urls.url
user.entities.url.urls.expanded_url	includes.users.entities.url.urls.expanded_url	expansions=author_id&user.fields=entities
user.entities.url.urls.display_url	includes.users.entities.url.urls.display_url	expansions=author_id&user.fields=entities
user.entities.url.urls.display_url.indicies[0]	includes.users.entities.url.urls.start	expansions=author_id&user.fields=entities
user.entities.url.urls.display_url.indicies[1]	includes.users.entities.url.urls.end	expansions=author_id&user.fields=entities
user.protected	includes.users.protected	expansions=author_id&user.fields=protected
user.followers_count	includes.users.public_metrics.followers_count	expansions=author_id&user.fields=public_metrics
user.friends_count	includes.users.public_metrics.following_count	expansions=author_id&user.fields=public_metrics
user.listed_count	includes.users.public_metrics.listed_count	expansions=author_id&user.fields=public_metrics
user.created_at	includes.users.created_at	expansions=author_id&user.fields=created_at
user.favourites_count
user.verified	includes.users.verified	expansions=author_id&user.fields=verified
user.statuses_count	includes.users.public_metrics.tweet_count	expansions=author_id&user.fields=public_metrics
user.profile_image_url_https	includes.users.profile_image_url	expansions=author_id&user.fields=profile_image_url

Exemple

Objet User dans v1.1	Objet utilisateur et requête en v2
”user”:{ “id”: 2244994945, “id_str”:“2244994945”, “name”:“Twitter Dev”, “screen_name”:“TwitterDev”, “location”:“127.0.0.1”, “description”:“La voix de l’équipe #TwitterDev et votre source officielle de mises à jour, d’actualités et d’événements relatifs à l’#TwitterAPI.”, “url”:“https://t.co/3ZX3TNiZCY”, “entities”:{ “url”:{ “urls”: [{ “url”:“https://t.co/3ZX3TNiZCY”, “étendue_url”:“https://developer.x.com/fr/community”, “display_url”:“developer.x.com/fr/community”, “indices”: [ 0, 23 ] }] }, “description”:{ “urls”: [] } }, “protected”: false, “followers_count”: 517232, “friends_count”: 2032, “répertorié_count”: 1722, “créé_à”:“Sat Dec 14 04:35:55 +0000 2013”, “favourites_count”: 2134, “UTC_offset”: null, “fuseau horaire_zone”: null, “geo_activé”: true, “vérifié”: true, “statuses_count”: 3677, “lang”: null, “contributeurs_activé”: false, “est_traducteur”: false, “est_traduction_activé”: false, “profile_arrière-plan_color”:“FFFFFF”, “profil_arrière-plan_image_url”:“http://abs.twimg.com/images/themes/theme1/bg.png”, “profile_arrière-plan_image_url_https”:“https://abs.twimg.com/images/themes/theme1/bg.png”, “profil_arrière-plan_mosaïque”: false, “profil_image_url”:“http://pbs.twimg.com/profile_images/1354494203451961345/d8HkZl6p_normal.jpg”, “profile_image_url_https”:“https://pbs.twimg.com/profile_images/1354494203451961345/d8HkZl6p_normal.jpg”, “profil_banner_url”:“https://pbs.twimg.com/profile_banners/2244994945/1611792896”, “profil_lien_color”:“0084B4”, “profile_sidebar_border_color”:“FFFFFF”, “profil_sidebar_remplir_color”:“DDEEF6”, “profil_text_color”:“333333”, “profile_use_arrière-plan_image”: false, “a_extended_profile”: true, “par défaut_profile”: false, “par défaut_profil_image”: false, “following”: null, “follow_requête_envoyée”: null, “notifications”: null, “traducteur_type”:“regular” }	{ “data”: [{ “author_id”: “2244994945”, “id”: “1362876655061073928”, “text”: “De nos salons aux vôtres 🐱‍💻🛋️ Nos responsables des relations développeurs ont prévu des streams Twitch et des événements virtuels passionnants pour vous aider à démarrer avec la nouvelle #TwitterAPI. Consultez le programme pour plus de détails, et dites-nous si vous voulez en voir davantage !\n👇\nhttps://t.co/cixDY9qkvH” }], “includes”: { “users”: [{ “public_metrics”: { “followers_count”: 517233, “following_count”: 2034, “tweet_count”: 3677, “listed_count”: 1727 }, “username”: “TwitterDev”, “entities”: { “url”: { “urls”: [{ “start”: 0, “end”: 23, “url”: “https://t.co/3ZX3TNiZCY”, “expanded_url”: “https://developer.x.com/en/community”, “display_url”: “developer.x.com/en/community” }] }, “description”: { “hashtags”: [{ “start”: 17, “end”: 28, “tag”: “TwitterDev” }, { “start”: 105, “end”: 116, “tag”: “TwitterAPI” } ] } }, “description”: “La voix de l’équipe #TwitterDev et votre source officielle d’actualités, de mises à jour et d’événements liés à la #TwitterAPI.”, “name”: “Twitter Dev”, “verified”: true, “location”: “127.0.0.1”, “id”: “2244994945”, “protected”: false, “url”: “https://t.co/3ZX3TNiZCY”, “profile_image_url”: “https://pbs.twimg.com/profile_images/1354494203451961345/d8HkZl6p_normal.jpg”, “created_at”: “2013-12-14T04:35:55.000Z” }] } }

​

Objets entities et expanded entities

Format Twitter 1.1	Format Twitter v2	Paramètres v2 requis	Type dans v2
entities	data.entities	tweet.fields=entities	object
entities.hashtags	data.entities.hashtags	tweet.fields=entities	array of objects
entities.hashtags.indices[0]	data.entities.hashtags.start	tweet.fields=entities	number
entities.hashtags.indices[1]	data.entities.hashtags.end	tweet.fields=entities	number
entities.hashtags.text	data.entities.hashtags.tag	tweet.fields=entities	string
entities.urls	data.entities.urls	tweet.fields=entities	array of objects
entities.urls.indices[0]	data.entities.urls.start	tweet.fields=entities	number
entities.urls.indices[1]	data.entities.urls.end	tweet.fields=entities	number
entities.urls.url	data.entities.urls.url	tweet.fields=entities	string
entities.user_mentions	data.entities.mentions	tweet.fields=entities	array of objects
entities.user_mentions.indicies[0]	data.entities.mentions.start	tweet.fields=entities	number
entities.user_mentions.indicies[1]	data.entities.mentions.end	tweet.fields=entities	number
entities.user_mentions.screen_name	data.entities.mentions.username	tweet.fields=entities	string
entities.symbols	data.entities.cashtags	tweet.fields=entities	array of objects
entities.symbols.indices[0]	data.entities.cashtags.start	tweet.fields=entities	number
entities.symbols.indices[1]	data.entities.cashtags.end	tweet.fields=entities	number
entities.symbols.text	data.entities.cashtags.tag	tweet.fields=entities	string
entities.media	includes.media	expansions=attachments.media_keys	array of objects
entities.media.id_str	includes.media.media_key	expansions=attachments.media_keys	string
entities.media.type	includes.media.media.type	expansions=attachments.media_keys	string
entities.media.media_url		N/A, utilisez includes.media.url	string
entities.media.media_url_https	includes.media.url	expansions=attachments.media_keys&media.fields=url	string
entities.media.url
entities.media.display_url
entities.media.expanded_url
entities.media.media_url_https	includes.media.preview_image_url	expansions=attachments.media_keys&media.fields=preview_image_url	string
extended_entities	data.attachments	tweet_fields=attachments	object
extended_entities	data.attachments.media_keys	tweet.fields=attachments	array of objects
extended_entities.media	includes.media	expansions=attachments.media_keys	array of objects
extended_entities.media.id_str	includes.media.media_key	expansions=attachments.media_keys	string
extended_entities.media.type	includes.media.media.type	expansions=attachments.media_keys	string
extended_entities.media.sizes.thumb.w		Non disponible
extended_entities.media.sizes.thumb.h		Non disponible
extended_entities.media.sizes.thumb.resize		Non disponible
extended_entities.media.sizes.large.w	includes.media.height	expansions=attachments.media_keys&media.fields=height
extended_entities.media.sizes.large.h	includes.media.width	expansions=attachments.media_keys&media.fields=width
extended_entities.media.sizes.large.resize		Non disponible
extended_entities.media.sizes.small.w		Non disponible
extended_entities.media.sizes.small.h		Non disponible
extended_entities.media.sizes.small.resize		Non disponible
extended_entities.media.sizes.medium.w		Non disponible
extended_entities.media.sizes.medium.h		Non disponible
extended_entities.media.sizes.medium.resize		Non disponible
extended_entities.media.media_url_https	includes.media.url	expansions=attachments.media_keys&media.fields=url	string
extended_entities.media.media_url_https	includes.media.preview_image_url	expansions=attachments.media_keys&media.fields=preview_image_url	string
extended_entities.media.video_info.duration_millis	includes.media.duration_ms	expansions=attachments.media_keys&media.fields=duration_ms	number

Exemple

Entités et entités étendues dans l’API v1.1 (avec vidéo)	Entités, pièces jointes et includes dans la v2 https://api.x.com/2/tweets?ids=1370161532013735937&expansions=attachments.media_keys,entities.mentions.username&tweet.fields=entities&user.fields=created_at,description,entities,location,name,profile_image_url,protected,public_metrics,url,username,verified,withheld&media.fields=duration_ms,height,media_key,preview_image_url,public_metrics,type,url,width
”entities”:{ “hashtags”: [{ “texte”:“test”, “indices”: [ 8, 13 ] }], “symbols”: [], “utilisateur_mentions”: [{ “screen_name”:“TwitterDev”, “name”:“Twitter Dev”, “id”: 2244994945, “id_str”:“2244994945”, “indices”: [ 31, 42 ] }], “urls”: [{ “url”:“https://t.co/XVLZ3uwikc”, “étendue_url”:“https://developer.x.com/en”, “display_url”:“developer.x.com/en”, “indices”: [ 91, 114 ] }], “media”: [{ “id”: 1370161464028196868, “id_str”:“1370161464028196868”, “indices”: [ 115, 138 ], “media_url”:“http://pbs.twimg.com/ext_tw_video_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg”, “media_url_https”:“https://pbs.twimg.com/ext_tw_video_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg”, “url”:“https://t.co/dz4oByygWA”, “display_url”:“pic.x.com/dz4oByygWA”, “étendue_url”:“https://twitter.com/furiouscamper/status/1370161532013735937/video/1”, “type”:“photo”, “sizes”:{ “thumb”:{ “w”: 150, “h”: 150, “resize”:“crop” }, “small”:{ “w”: 383, “h”: 680, “resize”:“fit” }, “large”:{ “w”: 720, “h”: 1280, “resize”:“fit” }, “medium”:{ “w”: 675, “h”: 1200, “resize”:“fit” } } }] }, “extended_entities”:{ “media”: [{ “id”: 1370161464028196868, “id_str”:“1370161464028196868”, “indices”: [ 115, 138 ], “media_url”:“http://pbs.twimg.com/ext_tw_video_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg”, “media_url_https”:“https://pbs.twimg.com/ext_tw_video_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg”, “url”:“https://t.co/dz4oByygWA”, “display_url”:“pic.x.com/dz4oByygWA”, “étendu_url”:“https://twitter.com/furiouscamper/status/1370161532013735937/video/1”, “type”:“video”, “sizes”:{ “thumb”:{ “w”: 150, “h”: 150, “resize”:“crop” }, “small”:{ “w”: 383, “h”: 680, “resize”:“fit” }, “large”:{ “w”: 720, “h”: 1280, “resize”:“fit” }, “medium”:{ “w”: 675, “h”: 1200, “resize”:“fit” } }, “video_info”:{ “aspect_ratio”: [ 9, 16 ], “duration_millis”: 5140, “variants”: [{ “bitrate”: 950000, “content_type”:“video/mp4”, “url”:“https://video.twimg.com/ext_tw_video/1370161464028196868/pu/vid/480x852/rAuFVMEqs0MeP4P4.mp4?tag=12” }, { “bitrate”: 2176000, “content_type”:“video/mp4”, “url”:“https://video.twimg.com/ext_tw_video/1370161464028196868/pu/vid/720x1280/ZxVL5qYO-DNVuSyq.mp4?tag=12” }, { “content_type”:“application/x-mpegURL”, “url”:“https://video.twimg.com/ext_tw_video/1370161464028196868/pu/pl/EGVpuZpo-wYxTNCq.m3u8?tag=12” }, { “bitrate”: 632000, “content_type”:“video/mp4”, “url”:“https://video.twimg.com/ext_tw_video/1370161464028196868/pu/vid/320x568/M7VtocAwKPFdkqzF.mp4?tag=12” } ] }, “supplémentaires_media_info”:{ “monétisable”: false } }] }	{ “data”: [{ “entities”:{ “hashtags”: [{ “start”: 8, “end”: 13, “tag”:“test” }], “mentions”: [{ “start”: 31, “end”: 42, “username”:“TwitterDev” }], “urls”: [{ “start”: 91, “end”: 114, “url”:“https://t.co/XVLZ3uwikc”, “étendue_url”:“https://developer.x.com/en”, “display_url”:“developer.x.com/fr”, “status”: 200, “title”:“Cas d’utilisation, tutoriels,&Documentation”, “description”:“Publier&analyser les Tweets, optimiser les publicités,&créez des expériences client uniques avec l’API Twitter, l’API Twitter Ads,&Twitter for Websites. Commençons’Commençons à développer.”, “déroulé_url”:“https://developer.x.com/en” }, { “start”: 115, “end”: 138, “url”:“https://t.co/dz4oByygWA”, “étendue_url”:“https://x.com/furiouscamper/status/1370161532013735937/video/1”, “display_url”:“pic.x.com/dz4oByygWA” } ] }, “id”:“1370161532013735937”, “texte”:“Another #test with a video and @TwitterDev mention. Excited for new format migration docs! https://t.co/XVLZ3uwikc https://t.co/dz4oByygWA”, “attachments”:{ “media_clés”: [ “7_1370161464028196868” ] } }], “includes”:{ “media”: [{ “type”:“video”, “height”: 1280, “public_metrics”:{ “affichage_count”: 37 }, “width”: 720, “media_clé”:“7_1370161464028196868”, “duration_ms”: 5140, “prévisualisation_image_url”:“https://pbs.twimg.com/ext_tw_video_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg” }], “users”: [{ “public_metrics”:{ “followers_count”: 517233, “suivante_count”: 2034, “tweet_count”: 3677, “listé_count”: 1727 }, “créée_à”:“2013-12-14T04:35:55.000Z”, “profil_image_url”:“https://pbs.twimg.com/profile_images/1354494203451961345/d8HkZl6p_normal.jpg”, “description”:“La voix de l’équipe #TwitterDev et votre source officielle de mises à jour, d’actualités et d’événements relatifs à l’#TwitterAPI.”, “certifié”: true, “id”:“2244994945”, “username”:“TwitterDev”, “protected”: false, “entities”:{ “url”:{ “urls”: [{ “start”: 0, “end”: 23, “url”:“https://t.co/3ZX3TNiZCY”, “étendue_url”:“https://developer.x.com/fr/community”, “display_url”:“developer.x.com/fr/community” }] }, “description”:{ “hashtags”: [{ “start”: 17, “end”: 28, “tag”:“TwitterDev” }, { “start”: 105, “end”: 116, “tag”:“TwitterAPI” } ] } }, “url”:“https://t.co/3ZX3TNiZCY”, “name”:“Twitter Dev”, “location”:“127.0.0.1” }] } }

---

​

Objet Place

Format Twitter 1.1	Format Twitter v2	Paramètres requis pour v2
place	data.geo.place_id	tweet.fields=geo
place.id	includes.places.id	expansions=geo.place_id
place.id.place_type	includes.places.place_type	expansions=geo.place_id&place.fields=place_type
place.id.name	includes.places.name	expansions=geo.place_id&place.fields=name
place.id.full_name	includes.places.full_name	expansions=geo.place_id
place.id.country_code	includes.places.country_code	expansions=geo.place_id&place.fields=country_code
place.id.country	includes.places.country	expansions=geo.place_id&place.fields=country
place.id.contained_within	includes.places.contained_within	expansions=geo.place_id&place.fields=contained_within
place.id.bounding_box.type	includes.places.geo.type	expansions=geo.place_id&place.fields=place_type
place.id.bounding_box.coordinates	includes.places.geo.bbox	expansions=geo.place_id&place.fields=geo
place.id.attributes	includes.places.properties	expansions=geo.place_id&place.fields=geo

Exemple

Objet Place dans v1.1	Objet Place avec v2 https://api.x.com/2/tweets?ids=1370161532013735937&expansions=geo.place_id&tweet.fields=geo&place.fields=contained_within,country,country_code,full_name,geo,id,name,place_type
”place”: { “id”: “f7eb2fa2fea288b1”, “url”: “https://api.x.com/1.1/geo/id/f7eb2fa2fea288b1.json”, “place_type”: “city”, “name”: “Lakewood”, “full_name”: “Lakewood, CO”, “country_code”: “US”, “country”: “United States”, “contained_within”: [], “bounding_box”: { “type”: “Polygon”, “coordinates”: [ [ [ -105.193475, 39.60973 ], [ -105.053164, 39.60973 ], [ -105.053164, 39.761974 ], [ -105.193475, 39.761974 ] ] ] }, “attributes”: }	{ “data”: [{ “id”: “1370161532013735937”, “text”: “Another #test with a video and @TwitterDev mention. Excited for new format migration docs! https://t.co/XVLZ3uwikc https://t.co/dz4oByygWA”, “geo”: { “place_id”: “f7eb2fa2fea288b1” } }], “includes”: { “places”: [{ “name”: “Lakewood”, “place_type”: “city”, “full_name”: “Lakewood, CO”, “id”: “f7eb2fa2fea288b1”, “geo”: { “type”: “Feature”, “bbox”: [ -105.193475, 39.60973, -105.053164, 39.761974 ], “properties”: }, “country_code”: “US”, “country”: “United States” }] }

Étape suivante

• En savoir plus sur les champs
• En savoir plus sur les expansions
• Découvrez comment utiliser les champs avec les expansions

​

Migration du format de données Native Enriched vers la v2

Le format de données Native Enriched est utilisé par nos produits enterprise.

Le format de données Native Enriched a été mis à jour pour fournir des métadonnées relatives aux Tweets modifiés. Pour en savoir plus sur les métadonnées d’édition de Tweets, consultez la page Principes fondamentaux de l’édition de Tweets.

Si vous utilisez les endpoints standard v1.1, veuillez vous référer au guide de migration de la version standard v1.1 vers la v2. Si vous utilisez les produits enterprise avec Activity Streams, nous proposons également un guide Activity Streams vers v2.

X API v2 introduit de nouveaux schémas JSON pour les objets Tweet et user.

• Au niveau racine du JSON, le format Native Enriched renvoie les objets Tweet dans un tableau results, tandis que X API v2 renvoie un tableau data. 
• Au lieu d’utiliser à la fois favorites (dans l’objet Tweet) et favourites (dans l’objet user), X API v2 utilise le terme like. 
• X adopte la convention selon laquelle les valeurs JSON vides (par exemple null) ne sont pas écrites dans la charge utile. Les attributs de Tweet et de user ne sont inclus que s’ils ont des valeurs non null. 
• Tous les champs id en v2 seront au format chaîne de caractères  

En plus des modifications apportées au nouveau format JSON, nous avons également introduit un nouvel ensemble de champs dans l’objet Tweet, notamment les suivants :

• conversation_id
• reply_settings
• alt_text sur les médias
• Deux nouveaux champs annotations, notamment context et entities
• Plusieurs nouveaux champs metrics
• Plusieurs nouveaux champs polls  

De nombreux champs hérités et obsolètes sont supprimés :

• contributors
• Certains champs entities.media et extended_entities.media
• filter_level
• timestamp_ms
• truncated

​

Structure de payload Native Enriched vs v2

Le tableau suivant présente les objets de haut niveau et le format que vous recevrez avec v2 par rapport au format Native Enriched.

	Structure Native Enriched	Structure v2
Par défaut	{ tweet object fields, “user”: , “place”: , “entities”: { “hashtags”: [], “urls”: [], “user_mentions”: [], “symbols”: [], “annotations”: [], “media”: [] }, “extended_entities”: , “matching_rules”: [] }	{ “data”: [{ “id”, “text”, “edit_history_tweet_ids” }] }
Avec des paramètres champs et expansions définis		{ “data”: [{ tweet object fields, “entities”: { “hashtags”: [], “cashtags”: [], “mentions”: [], “urls”: [], }, “attachments”: { “media_keys”: [], “poll_ids”: [] } }], “includes”: [ “tweets”: [user objects], “users”: [user objects], “media”: [media objects], “places”: [place object], “polls”: [poll object] ], “matching_rules”: [] }

Mappage des champs

La section suivante décrit quels champs Native Enriched correspondent à des champs v2, ainsi que les paramètres v2 requis pour recevoir ces nouveaux champs.  

​

Objet Tweet

Format Native Enriched	Format v2 de Twitter	Paramètres v2 obligatoires	Type en v2
created_at	data.created_at	tweet.fields=created_at	Chaîne de caractères
id		Non applicable : voir id
id_str	data.id	Par défaut	Chaîne de caractères
text	data.text	Par défaut	Chaîne de caractères
edit_history	data.edit_history_tweet_ids	Par défaut	Tableau
edit_controls	data.edit_controls	tweet.fields=edit_controls	Objet
editable	data.edit_controls.is_edit_eligible	tweet.fields=edit_controls	Booléen
display_text_range		Non applicable : text inclut l’intégralité du texte
source	data.source	tweet.fields=source	Chaîne de caractères
truncated		Non applicable : text inclut l’intégralité du texte
Non disponible	data.conversation_id	tweet.fields=conversation_id	Chaîne de caractères
Non disponible	data.reply_settings	tweet.fields=reply_settings	String
in_reply_to_status_id		N/A - voir referenced_tweets.id
in_reply_to_status_id_str	data.referenced_tweets.id (si type=replied_to)	expansions=referenced_tweets.id	String
in_reply_to_user_id		N/A - voir in_reply_to_user_id_str
in_reply_to_user_id_str	data.in_reply_to_user_id	tweet.fields=in_reply_to_user_id	String
in_reply_to_screen_name	includes.users..username	tweet.fields=in_reply_to_user_id&expansions=entities.mentions.username	String
user	includes.users	expansions=author_id	Object
user.id_str	data.author_id	tweet.fields=author_id	String
geo	data.geo.place_id	tweet.fields=geo
coordinates	data.geo.place_id	tweet.fields=geo
place	data.geo.place_id	tweet.fields=geo
is_quoted_status	data.referenced_tweets.id (si type=quoted)	tweet.fields=referenced_tweets	String
extended_tweet.full_text		N/A - texte complet
Non disponible	data.public_metrics	tweet.fields=public_metrics	Objet
quote_count	data.public_metrics.quote_count	tweet.fields=public_metrics	Int
reply_count	data.public_metrics.reply_count	tweet.fields=public_metrics	Int
retweet_count	data.public_metrics.retweet_count	tweet.fields=public_metrics	Int
favorite_count	data.public_metrics.like_count	tweet.fields=public_metrics	Int
Non disponible	data.non_public_metrics	tweet.fields=non_public_metrics	Objet
Non disponible	data.non_public_metrics.impression_count	tweet.fields=non_public_metrics	Int
Non disponible	data.non_public_metrics.url_link_count	tweet.fields=non_public_metrics	Int
Non disponible	data.non_public_metrics.user_profile_count	tweet.fields=non_public_metrics	Int
Non disponible	data.organic_metrics	tweet.fields=organic_metrics	Object
Non disponible	data.organic_metrics.like_count	tweet.fields=organic_metrics	Int
Non disponible	data.organic_metrics.retweet_count	tweet.fields=organic_metrics	Int
Non disponible	data.organic_metrics.reply_count	tweet.fields=organic_metrics	Int
Non disponible	data.organic_metrics.impression_count	tweet.fields=organic_metrics	Int
Non disponible	data.organic_metrics.url_link_count	tweet.fields=organic_metrics	Int
Non disponible	data.organic_metrics.user_profile_count	tweet.fields=organic_metrics	Int
Non disponible	data.promoted_metrics	tweet.fields=promoted_metrics	Object
Non disponible	data.promoted_metrics.like_count	tweet.fields=promoted_metrics	Int
Non disponible	data.promoted_metrics.retweet_count	tweet.fields=promoted_metrics	Int
Non disponible	data.promoted_metrics.reply_count	tweet.fields=promoted_metrics	Int
Non disponible	data.promoted_metrics.impression_count	tweet.fields=promoted_metrics	Int
Non disponible	data.promoted_metrics.url_link_count	tweet.fields=promoted_metrics	Int
Non disponible	data.promoted_metrics.user_profile_count	tweet.fields=promoted_metrics	Int
contributors	Non disponible	Non disponible
entities	data.entities	tweet.fields=entities	Objet
entities.user_mentions	data.entities.mentions	tweet.fields=entities	Tableau d’objets
entities.symbols	data.entities.cashtags	tweet.fields=entities	Tableau d’objets
entities.hashtags	data.entities.hashtags	tweet.fields=entities	Tableau d’objets
entities.urls	data.entities.urls	tweet.fields=entities	Tableau d’objets
entities.media	includes.media	expansions=attachments.media_keys	Tableau d’objets
entities.annotations		tweet.fields=entities,context_annotations	Objet
entities.annotations.context	data.context_annotations	tweet.fields=entities,context_annotations	Tableau d’objets
Aucun équivalent	data.context_annotations.domain	tweet.fields=context_annotations	Objet
entities.annotations.context.context_domain_id_str	data.context_annotations.domain.id	tweet.fields=context_annotations	Chaîne de caractères
entities.annotations.context.context_domain_id	Non disponible	Non disponible – voir data.context_annotations.domain.id pour le format de chaîne
entities.annotations.context.context_domain_name	data.context_annotations.domain.name	tweet.fields=context_annotations	Chaîne de caractères
entities.annotations.context.context_domain_description	data.context_annotations.domain.description	tweet.fields=context_annotations	Chaîne de caractères
Aucun équivalent	data.context_annotations.entity	tweet.fields=context_annotations	Objet
entities.annotations.context.context_entity_id_str	data.context_annotations.entity.id	tweet.fields=context_annotations	Chaîne de caractères
entities.annotations.context.context_entity_id	Non disponible	Non disponible – voir data.context_annotations.entity.id pour le format de chaîne
entities.annotations.context.context_entity_name	data.context_annotations.entity.name	tweet.fields=context_annotations	Chaîne de caractères
entities.annotations.context.context_entity_description	data.context_annotations.entity.description	tweet.fields=context_annotations	Chaîne de caractères
entities.annotations.entity	data.entities.annotations	tweet.fields=entities,context_annotations	Tableau d’objets
extended_entities	data.attachments	tweet.fields=attachments	Objet
favorited	Non disponible	Non disponible
retweeted	Non disponible	Non disponible
retweeted_status
possibly_sensitive	data.possibly_sensitive	tweet.fields=possibly_sensitive	Booléen
lang	data.lang	tweet.fields=lang	Chaîne de caractères
filter_level	Non disponible	Non disponible
scopes	Non disponible	Non disponible
timestamp_ms	Non disponible	Non disponible
withheld	data.withheld	tweet.fields=withheld	Tableau d’objets
matching_rules	matching_rules		Tableau d’objets
matching_rules.id	Non disponible	Non disponible
matching_rules.id_str	Représentation sous forme de chaîne de matching_rules.id	Valeur par défaut pour le flux filtré	Chaîne de caractères
matching_rules.tag	matching_rules.tag	Valeur par défaut pour le flux filtré	Chaîne de caractères

​

Objet User

Format Native Enriched	Format v2 de Twitter	Paramètres requis pour v2	Type dans v2
user	includes.users	expansions=author_id	Tableau d’objets
user.id	Non disponible	N/A - voir includes.users.id	Chaîne
user.id_str	includes.users.id	expansions=author_id	Chaîne
user.name	includes.users.name	expansions=author_id	Chaîne
user.screen_name	includes.user.username	expansions=author_id	Chaîne
user.location	includes.users.location	expansions=author_id&user.fields=location	Objet
user.description	includes.users.description	expansions=author_id&user.fields=description	Chaîne
Non disponible	includes.users.url	expansions=author_id&user.fields=url	Chaîne
user.followers_count	includes.users.public_metrics.followers_count	expansions=author_id&user.fields=public_metrics	Entier
user.friends_count	includes.users.public_metrics.following_count	expansions=author_id&user.fields=public_metrics	Entier
user.listed_count	includes.users.public_metrics.listed_count	expansions=author_id&user.fields=public_metrics	Entier
user.created_at	includes.users.created_at	expansions=author_id&user.fields=created_at	Chaîne de caractères
user.favourites_count		Pas encore disponible
user.verified	includes.users.verified	expansions=author_id&user.fields=verified	Booléen
Non disponible	includes.users.pinned_tweet_id	expansions=author_id&user.fields=pinned_tweet_id	Chaîne de caractères
user.statuses_count	includes.users.public_metrics.tweet_count	expansions=author_id&user.fields=public_metrics	Entier
user.profile_image_url_https	includes.users.profile_image_url	expansions=author_id&user.fields=profile_image_url	Chaîne de caractères
user.translator_type	Non disponible	Non disponible
user.utc_offset	Non disponible	Non disponible
user.time_zone	Non disponible	Non disponible
user.geo_enabled	Non disponible	Non disponible
user.lang	Non disponible — dérivé de la langue du Tweet	Non disponible – à déduire à partir de la langue du Tweet
user.contributors_enabled	Non disponible	Non disponible
user.is_translator	Non disponible	Non disponible
user.profile_background_color	Non disponible	Non disponible
user.profile_background_image_url	Non disponible	Non disponible
user.profile_background_image_url_https	Non disponible	Non disponible
user.profile_background_title	Non disponible	Non disponible
user.profile_sidebar_border_color	Non disponible	Non disponible
user.profile_sidebar_fill_color	Non disponible	Non disponible
user.profile_text_color	Non disponible	Non disponible
user.profile_user_background_image	Non disponible	Non disponible
user.profile_image_url		Voir includes.user.profile_image_url
user.default_profile	Non disponible	Non disponible
user.default_profile_image	Non disponible	Non disponible
user.following	Non disponible	Non disponible
user.follow_request_sent	Non disponible	Non disponible
user.notifications	Non disponible	Non disponible
user.withheld_in_countries	includes.users.withheld	expansions=author_id&user.fields=withheld	Objet
user.protected	includes.users.protected	expansions=author_id&user.fields=protected	Booléen
Non disponible	includes.users.entities	expansions=author_id&user.fields=entities	Objet
Non disponible	includes.users.entities.url	expansions=author_id&user.fields=entities	Objet
Non disponible	includes.users.entities.url.urls	expansions=author_id&user.fields=entities	Tableau d’objets
Non disponible	includes.users.entities.url.urls.start	expansions=author_id&user.fields=entities	Entier
Non disponible	includes.users.entities.url.urls.end	expansions=author_id&user.fields=entities	Entier
Non disponible	includes.users.entities.url.urls.url	expansions=author_id&user.fields=entities	Chaîne de caractères
user.url	includes.users.entities.url.urls.expanded_url	expansions=author_id&user.fields=entities	Chaîne de caractères
Non disponible	includes.users.entities.url.urls.display_url	expansions=author_id&user.fields=entities	Chaîne de caractères
Non disponible	includes.users.entities.descriptions	expansions=author_id&user.fields=entities	Objet
Non disponible	includes.users.entities.descriptions.hashtags	expansions=author_id&user.fields=entities	Tableau d’objets
Non disponible	includes.users.entities.descriptions.hashtags.start	expansions=author_id&user.fields=entities	Entier
Non disponible	includes.users.entities.descriptions.hashtags.end	expansions=author_id&user.fields=entities	Entier
Inclus dans user.description	includes.users.entities.descriptions.hashtags.tag	expansions=author_id&user.fields=entities	Chaîne de caractères
Non disponible	includes.users.entities.descriptions.mentions	expansions=author_id&user.fields=entities	Tableau d’objets
Non disponible	includes.users.entities.descriptions.mentions.start	expansions=author_id&user.fields=entities	Entier
Non disponible	includes.users.entities.descriptions.mentions.end	expansions=author_id&user.fields=entities	Entier
Inclus dans user.description	includes.users.entities.descriptions.mentions.username	expansions=author_id&user.fields=entities	Chaîne de caractères
Non disponible	includes.users.entities.descriptions.cashtags	expansions=author_id&user.fields=entities	Tableau d’objets
Non disponible	includes.users.entities.descriptions.cashtags.start	expansions=author_id&user.fields=entities	Entier
Non disponible	includes.users.entities.descriptions.cashtags.end	expansions=author_id&user.fields=entities	Entier
Inclus dans user.description	includes.users.entities.descriptions.cashtags.tag	expansions=author_id&user.fields=entities	Chaîne de caractères

​

Objets entities et expanded entities

Format enrichi natif	Format Twitter v2	Paramètres v2 obligatoires	Type au format v2
entities	data.entities	tweet.fields=entities	Objet
entities.hashtags	data.entities.hashtags	tweet.fields=entities	Tableau d’objets
entities.hashtags.indices[0]	data.entities.hashtags.start	tweet.fields=entities	Entier
entities.hashtags.indices[1]	data.entities.hashtags.end	tweet.fields=entities	Entier
entities.hashtags.text	data.entities.hashtags.tag	tweet.fields=entities	Chaîne de caractères
entities.urls	data.entities.urls	tweet.fields=entities	Tableau d’objets
entities.urls.indices[0]	data.entities.urls.start	tweet.fields=entities	Entier
entities.urls.indices[1]	data.entities.urls.end	tweet.fields=entities	Entier
entities.urls.url	data.entities.urls.url	tweet.fields=entities	Chaîne de caractères
entities.urls.expanded_url	data.entities.urls.expanded_url	tweet.fields=entities	Chaîne de caractères
entities.urls.display_url	data.entities.urls.display_url	tweet.fields=entities	String
entities.urls.unwound.url	data.entities.urls.unwound_url	tweet.fields=entities	String
entities.urls.unwound.status	data.entities.urls.status	tweet.fields=entities	String
entities.urls.unwound.title	data.entities.urls.title	tweet.fields=entities	String
entities.urls.unwound.description	data.entities.urls.description	tweet.fields=entities	String
Non disponible	data.entities.urls.images	tweet.fields=entities	Tableau d’objets
Non disponible	data.entities.urls.images.url	tweet.fields=entities	String
Non disponible	data.entities.urls.images.width	tweet.fields=entities	Int
Non disponible	data.entities.urls.images.height	tweet.fields=entities	Int
entities.user_mentions	data.entities.mentions	tweet.fields=entities	Tableau d’objets
entities.user_mentions.indicies[0]	data.entities.mentions.start	tweet.fields=entities	Entier
entities.user_mentions.indicies[1]	data.entities.mentions.end	tweet.fields=entities	Entier
entities.user_mentions.screen_name	data.entities.mentions.username	tweet.fields=entities	Chaîne de caractères
entities.symbols	data.entities.cashtags	tweet.fields=entities	Tableau d’objets
entities.symbols.indices[0]	data.entities.cashtags.start	tweet.fields=entities	Entier
entities.symbols.indices[1]	data.entities.cashtags.end	tweet.fields=entities	Entier
entities.symbols.text	data.entities.cashtags.tag	tweet.fields=entities	Chaîne de caractères
entities.media OR extended_entities.media	includes.media	expansions=attachments.media_keys	Tableau d’objets
entities.media.id_str OR extended_entities.media.id_str	includes.media.media_key	expansions=attachments.media_keys	Chaîne de caractères
entities.media.id OR extended_entities.media.id		Non disponible : id est une chaîne de caractères
entities.media.type OR extended_entities.media.type	includes.media.type	expansions=attachments.media_keys	Chaîne de caractères
entities.media.indices OR extended_entities.media.indices	Non disponible	Non disponible
Non disponible	includes.media.alt_text	expansions=attachments.media_keys&media.fields=alt_text	Chaîne de caractères
entities.media.additional_media_info OR extended_entities.media.additional_media_info	Non disponible	Non disponible
entities.media.additional_media_info.monetizable OR extended_entities.media.additional_media_info.monetizable	Non disponible	Non disponible
entities.media.media_url OR extended_entities.media.media_url		N/A – voir includes.media.url	Chaîne de caractères
entities.media.media_url_https OR extended_entities.media.media_url_https	includes.media.url	expansions=attachments.media_keys&media.fields=url	Chaîne de caractères
entities.media.url OR extended_entities.media.url
entities.media.display_url OR extended_entities.media.expanded_url
entities.media.expanded_url
entities.media.media_url_https	includes.media.preview_image_url	expansions=attachments.media_keys&media.fields=preview_image_url	Chaîne de caractères
extended_entities	data.attachments	tweet_fields=attachments	Objet
extended_entities	data.attachments.media_keys	tweet.fields=attachments	Tableau d’objets
Non disponible	data.attachments.poll_ids	tweet.fields=attachments	Tableau d’objets
extended_entities.media.sizes.thumb.w		Non disponible
extended_entities.media.sizes.thumb.h		Non disponible
extended_entities.media.sizes.thumb.resize		Non disponible
extended_entities.media.sizes.large.w	includes.media.height	expansions=attachments.media_keys&media.fields=height
extended_entities.media.sizes.large.h	includes.media.width	expansions=attachments.media_keys&media.fields=width
extended_entities.media.sizes.large.resize	Non disponible	Non disponible
extended_entities.media.sizes.small.w	Non disponible	Non disponible
extended_entities.media.sizes.small.h	Non disponible	Non disponible
extended_entities.media.sizes.small.resize	Non disponible	Non disponible
extended_entities.media.sizes.medium.w	Non disponible	Non disponible
extended_entities.media.sizes.medium.h	Non disponible	Non disponible
extended_entities.media.sizes.medium.resize	Non disponible	Non disponible
extended_entities.media.media_url_https	includes.media.preview_image_url	expansions=attachments.media_keys&media.fields=preview_image_url	Chaîne de caractères
extended_entities.media.video_info.aspect_ratio	Non disponible	Non disponible
extended_entities.media.variants	Non disponible	Non disponible
extended_entities.media.variants.bitrate	Non disponible	Non disponible
extended_entities.media.variants.content_type	Non disponible	Non disponible
extended_entities.media.variants.url	Non disponible	Non disponible
extended_entities.media.video_info.duration_millis	includes.media.duration_ms	expansions=attachments.media_keys&media.fields=duration_ms	Int
Non disponible	includes.media.public_metrics	expansions=attachments.media_keys&media.fields=public_metrics	Object
Non disponible	includes.media.public_metrics.view_count	expansions=attachments.media_keys&media.fields=public_metrics	Int
Non disponible	includes.media.non_public_metrics	expansions=attachments.media_keys&media.fields=non_public_metrics	Object
Non disponible	includes.media.non_public_metrics.playback_0_count	expansions=attachments.media_keys&media.fields=non_public_metrics	Int
Non disponible	includes.media.non_public_metrics.playback_25_count	expansions=attachments.media_keys&media.fields=non_public_metrics	Int
Non disponible	includes.media.non_public_metrics.playback_50_count	expansions=attachments.media_keys&media.fields=non_public_metrics	Int
Non disponible	includes.media.non_public_metrics.playback_75_count	expansions=attachments.media_keys&media.fields=non_public_metrics	Int
Non disponible	includes.media.non_public_metrics.playback_100_count	expansions=attachments.media_keys&media.fields=non_public_metrics	Int
Non disponible	includes.media.organic_metrics	expansions=attachments.media_keys&media.fields=organic_metrics	Objet
Non disponible	includes.media.organic_metrics.playback_0_count	expansions=attachments.media_keys&media.fields=organic_metrics	Int
Non disponible	includes.media.organic_metrics.playback_25_count	expansions=attachments.media_keys&media.fields=organic_metrics	Int
Non disponible	includes.media.organic_metrics.playback_50_count	expansions=attachments.media_keys&media.fields=organic_metrics	Int
Non disponible	includes.media.organic_metrics.playback_75_count	expansions=attachments.media_keys&media.fields=organic_metrics	Int
Non disponible	includes.media.organic_metrics.playback_100_count	expansions=attachments.media_keys&media.fields=organic_metrics	Int
Non disponible	includes.media.organic_metrics.view_count	expansions=attachments.media_keys&media.fields=organic_metrics	Int
Non disponible	includes.media.promoted_metric	expansions=attachments.media_keys&media.fields=promoted_metrics	Objet
Non disponible	includes.media.promoted_metric.playback_0_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Int
Non disponible	includes.media.promoted_metric.playback_25_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Int
Non disponible	includes.media.promoted_metric.playback_50_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Int
Non disponible	includes.media.promoted_metric.playback_75_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Int
Non disponible	includes.media.promoted_metric.playback_100_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Int
Non disponible	includes.media.promoted_metrics.view_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Int

​

Objet Place

Format natif enrichi	Format Twitter v2	Paramètres v2 requis	Type dans v2
place	includes.places	expansions=geo.place_id	Tableau d’objets
place.id	includes.places.id	expansions=geo.place_id	Chaîne de caractères
place.url	Non disponible	Non disponible
place.id.place_type	includes.places.place_type	expansions=geo.place_id&place.fields=place_type	Chaîne de caractères
place.id.name	includes.places.name	expansions=geo.place_id&place.fields=name	Chaîne de caractères
place.id.full_name	includes.places.full_name	expansions=geo.place_id	Chaîne de caractères
place.id.country_code	includes.places.country_code	expansions=geo.place_id&place.fields=country_code	Chaîne de caractères
place.id.country	includes.places.country	expansions=geo.place_id&place.fields=country	Chaîne de caractères
place.id.contained_within	includes.places.contained_within	expansions=geo.place_id&place.fields=contained_within	Tableau
place.id.bounding_box.type	includes.places.geo.type	expansions=geo.place_id&place.fields=place_type	Chaîne de caractères
place.id.bounding_box.coordinates	includes.places.geo.bbox	expansions=geo.place_id&place.fields=geo	Tableau
place.id.attributes	includes.places.properties	expansions=geo.place_id&place.fields=geo	Objet

​

Objet de sondage

Format enrichi natif	Format Twitter v2	Paramètres v2 requis	Type dans v2
entities.polls	includes.polls	expansions=attachments.poll_ids	Tableau d’objets
Non disponible	includes.polls.id	expansions=attachments.poll_ids	Chaîne
entities.poll.options	includes.polls.options	expansions=attachments.poll_ids	Tableau d’objets
entities.polls.options.position	includes.polls.options.position	expansions=attachments.poll_ids	Entier
entities.polls.options.text	includes.polls.options.label	expansions=attachments.poll_ids	Chaîne
Non disponible	includes.polls.options.votes	expansions=attachments.poll_ids	Entier
Non disponible	includes.polls.voting_status	expansions=attachments.poll_ids&poll.fields=voting_status	Chaîne
entities.polls.duration_minutes	includes.polls.duration_minutes	expansions=attachments.poll_ids&poll.fields=duration_minutes	Entier
entities.polls.end_datetime	includes.polls.end_datetime	expansions=attachments.poll_ids&poll.fields=end_datetime	Date (ISO 8601)

​

Migration du format de données Activity Streams vers la v2

Le format de données Activity Streams est disponible avec nos produits enterprise.

Le format de données Activity Streams a été mis à jour pour fournir des métadonnées de Tweet modifié. Pour en savoir plus sur les métadonnées de Tweet modifié, consultez la page Principes de base des Tweets modifiés.

Si vous utilisez les endpoints standard v1.1, reportez-vous au guide de migration standard v1.1 vers v2. Si vous utilisez les endpoints premium ou le format Native Enriched pour enterprise, reportez-vous au guide Native Enriched vers v2.

X API v2 introduit de nouveaux modèles JSON pour les objets Publication et utilisateur.

• Au niveau racine du JSON, le format Activity Streams renvoie les objets Tweet dans un tableau results, tandis que X API v2 renvoie un tableau data. 
• Au lieu de faire référence à des « activités » Retweeted et Quoted, le JSON de X API v2 fait référence à des Tweets Retweeted et Quoted. 
• Au lieu d’utiliser à la fois favorites (dans l’objet Tweet) et favourites (dans l’objet user), X API v2 utilise le terme like. 
• Twitter adopte la convention selon laquelle les valeurs JSON sans valeur (par exemple null) ne sont pas incluses dans la charge utile. Les attributs de Tweet et de user ne sont inclus que s’ils ont des valeurs non null. 
• Tous les champs id en v2 seront au format chaîne de caractères.  

En plus des modifications apportées au nouveau format JSON, nous avons également introduit un nouvel ensemble de champs dans l’objet Tweet, notamment les suivants :

• conversation_id
• reply_settings
• alt_text sur les médias
• Deux nouveaux champs annotations, notamment context et entities
• Plusieurs nouveaux champs metrics
• Plusieurs nouveaux champs polls  

De nombreux champs hérités et obsolètes sont supprimés ou remplacés :

• display_text_range
• generator
• gnip
• link
• objectType
• provider
• twitter_entities.symbols remplacé par data.entities.cashtags
• Certains champs twitter_extended_entities.media et twitter_entities.media
• twitter_filter_level
• twitterTimeZone
• verb

​

Objet Tweet

Format Activity Streams	Format v2 de Twitter	Paramètres v2 obligatoires	Type dans v2
postedTime	data.created_at	tweet.fields=created_at	Date (ISO 8601)
generator	Non disponible	Non disponible
generator.link	Non disponible	Non disponible
generator.displayName	data.source	tweet.fields=source	Chaîne de caractères
twitter_lang	data.lang	tweet.fields=lang	Chaîne de caractères
Non disponible	data.conversation_id	tweet.fields=conversation_id	Chaîne de caractères
Non disponible	data.reply_settings	tweet.fields=reply_settings	Chaîne de caractères
Non disponible	data.possibly_sensitive	tweet.fields=possibly_sensitive	Booléen
Non disponible	data.withheld	tweet.fields=withheld	Objet
objectType	Non disponible	Non disponible
verb	Non disponible	Non disponible
provider	Non disponible	Non disponible
provider.objectType	Non disponible	Non disponible
provider.displayName	Non disponible	Non disponible
provider.link	Non disponible	Non disponible
link	Non disponible	Non disponible
display_text_range	Non disponible	Non disponible
object	Non disponible	Non disponible
object.objectType	Non disponible	Non disponible
object.id	Non disponible	Non disponible
object.summary	data.text	par défaut	String
object.edit_history	data.edit_history_tweet_ids	par défaut	Array
object.edit_controls	data.edit_controls	tweet.fields=edit_controls	Object
object.editable	data.edit_controls.is_edit_eligible	tweet.fields=edit_controls	Booléen
object.link	Non disponible	Non disponible
object.postedTime	data.created_at	tweet.fields=created_at	Date (ISO 8601)
Dérivé de actor.id	data.author_id	tweet.fields=created_at
twitter_filter_level	Non disponible	Non disponible
Dérivé du nom d’utilisateur dans inReplyTo.link	data.in_reply_to_user_id	tweet.fields=in_reply_to_user_id	Chaîne de caractères
Non disponible	data.referenced_tweets	tweet.fields=referenced_tweets	Tableau d’objets
Non disponible	data.referenced_tweets.type	tweet.fields=referenced_tweets	Chaîne de caractères
Dérivé de inReplyTo.link	data.referenced_tweets.id	tweet.fields=referenced_tweets	Chaîne de caractères
Non disponible	data.attachments	tweet.fields=attachments	Objet
Dérivé de twitter_entities.media.id_str	data.attachments.media_keys	tweet.fields=attachments	Tableau
Non disponible	data.attachments.poll_ids	tweet.fields=attachments	Tableau
twitter_entities	data.entities	tweet.fields=entities	Objet
Non disponible	data.entities.annotations	tweet.fields=entities	Tableau d’objets
Non disponible	data.entities.annotations.start	tweet.fields=entities	Entier
Non disponible	data.entities.annotations.end	tweet.fields=entities	Entier
Non disponible	data.entities.annotations.probability	tweet.fields=entities	Nombre à virgule flottante
Non disponible	data.entities.annotations.type	tweet.fields=entities	Chaîne de caractères
Non disponible	data.entities.annotations.normalized_text	tweet.fields=entities	Chaîne de caractères
twitter_entities.urls	data.entities.urls	tweet.fields=entities	Tableau d’objets
twitter_entities.urls.indices[0]	data.entities.urls.start	tweet.fields=entities	Entier
twitter_entities.urls.indices[1]	data.entities.urls.end	tweet.fields=entities	Entier
twitter_entities.urls.url	data.entities.urls.url	tweet.fields=entities	Chaîne
twitter_entities.urls.expanded_url	data.entities.urls.expanded_url	tweet.fields=entities	Chaîne
twitter_entities.urls.display_url	data.entities.urls.display_url	tweet.fields=entities	Chaîne
Non disponible	data.entities.urls.images	tweet.fields=entities	Tableau d’objets
Non disponible	data.entities.urls.images.url	tweet.fields=entities	Chaîne
Non disponible	data.entities.urls.images.width	tweet.fields=entities	Entier
Non disponible	data.entities.urls.images.height	tweet.fields=entities	Entier
gnip.urls.expanded_status	data.entities.urls.status	tweet.fields=entities	Entier
gnip.urls.expanded_url_title	data.entities.urls.title	tweet.fields=entities	Chaîne
gnip.urls.expanded_url_description	data.entities.urls.description	tweet.fields=entities	Chaîne de caractères
gnip.urls.expanded_url	data.entities.urls.unwound_url	tweet.fields=entities	Chaîne de caractères
twitter_entities.symbols	data.entities.cashtags	tweet.fields=entities	Tableau d’objets
twitter_entities.symbols.indices[0]	data.entities.cashtags.start	tweet.fields=entities	Entier
twitter_entities.symbols.indices[1]	data.entities.cashtags.end	tweet.fields=entities	Entier
twitter_entities.symbols.text	data.entities.cashtags.tag	tweet.fields=entities	Chaîne de caractères
twitter_entities.hashtags	data.entities.hashtags	tweet.fields=entities	Tableau d’objets
twitter_entities.hashtags.indices[0]	data.entities.hashtags.start	tweet.fields=entities	Entier
twitter_entities.hashtags.indices[1]	data.entities.hashtags.end	tweet.fields=entities	Entier
twitter_entities.hashtags.text	data.entities.hashtags.tag	tweet.fields=entities	Chaîne de caractères
twitter_entities.user_mentions	data.entities.mentions	tweet.fields=entities	Tableau d’objets
twitter_entities.user_mentions.indices[0]	data.entities.mentions.start	tweet.fields=entities	Int
twitter_entities.user_mentions.indices[1]	data.entities.mentions.end	tweet.fields=entities	Int
twitter_entities.user_mentions.screen_name	data.entities.mentions.tag	tweet.fields=entities	String
twitter_entities.user_mentions.id_str	data.entities.mentions.id	tweet.fields=entities	String
twitter_entities.user_mentions.id	Non disponible	Non disponible
Non disponible	data.context_annotations	tweet.fields=context_annotations	Tableau d’objets
Non disponible	data.context_annotations.domain	tweet.fields=context_annotations	Objet
Non disponible	data.context_annotations.domain.id	tweet.fields=context_annotations	String
Non disponible	data.context_annotations.domain.name	tweet.fields=context_annotations	String
Non disponible	data.context_annotations.domain.description	tweet.fields=context_annotations	Chaîne
Non disponible	data.context_annotations.entity	tweet.fields=context_annotations	Objet
Non disponible	data.context_annotations.entity.id	tweet.fields=context_annotations	Chaîne
Non disponible	data.context_annotations.entity.name	tweet.fields=context_annotations	Chaîne
Non disponible	data.context_annotations.entity.description	tweet.fields=context_annotations	Chaîne
geo	data.geo	tweet.fields=geo	Objet
Dérivé de location.link	data.geo.place_id	tweet.fields=geo	Chaîne
Non disponible	data.public_metrics	tweet.fields=public_metrics	Objet
favoritesCount	data.public_metrics.like_count	tweet.fields=public_metrics	Entier
retweetCount	data.public_metrics.retweet_count	tweet.fields=public_metrics	Entier
Non disponible	data.public_metrics.quote_count	tweet.fields=public_metrics	Int
Non disponible	data.public_metrics.reply_count	tweet.fields=public_metrics	Int
Non disponible	data.non_public_metrics	tweet.fields=non_public_metrics	Object
Non disponible	data.non_public_metrics.impression_count	tweet.fields=non_public_metrics	Int
Non disponible	data.non_public_metrics.url_link_count	tweet.fields=non_public_metrics	Int
Non disponible	data.non_public_metrics.user_profile_count	tweet.fields=non_public_metrics	Int
Non disponible	data.organic_metrics	tweet.fields=organic_metrics	Object
Non disponible	data.organic_metrics.like_count	tweet.fields=organic_metrics	Int
Non disponible	data.organic_metrics.retweet_count	tweet.fields=organic_metrics	Int
Non disponible	data.organic_metrics.reply_count	tweet.fields=organic_metrics	Int
Non disponible	data.organic_metrics.impression_count	tweet.fields=organic_metrics	Int
Non disponible	data.organic_metrics.url_link_count	tweet.fields=organic_metrics	Int
Non disponible	data.organic_metrics.user_profile_count	tweet.fields=organic_metrics	Int
Non disponible	data.promoted_metrics	tweet.fields=promoted_metrics	Objet
Non disponible	data.promoted_metrics.like_count	tweet.fields=promoted_metrics	Int
Non disponible	data.promoted_metrics.retweet_count	tweet.fields=promoted_metrics	Int
Non disponible	data.promoted_metrics.reply_count	tweet.fields=promoted_metrics	Int
Non disponible	data.promoted_metrics.impression_count	tweet.fields=promoted_metrics	Int
Non disponible	data.promoted_metrics.url_link_count	tweet.fields=promoted_metrics	Int
Non disponible	data.promoted_metrics.user_profile_count	tweet.fields=promoted_metrics	Int
gnip.profileLocations	Non disponible	Non disponible
gnip.profileLocations.address	Non disponible	Non disponible
gnip.profileLocations.address.country	Non disponible	Non disponible
gnip.profileLocations.address.countryCode	Non disponible	Non disponible
gnip.profileLocations.displayName	Non disponible	Non disponible
gnip.profileLocations.geo	Non disponible	Non disponible
gnip.profileLocations.geo.coordinates	Non disponible	Non disponible
gnip.profileLocations.geo.type	Non disponible	Non disponible
gnip.profileLocations.objectType	Non disponible	Non disponible

​

Objet utilisateur

Format Activity Streams	Format v2 de Twitter	Paramètres requis pour v2	Type dans v2
actor	includes.users	expansions=author_id	Tableau d’objets
Dérivé de actor.id	includes.users.id	expansions=author_id	Chaîne de caractères
actor.displayName	includes.users.name	expansions=author_id	Chaîne de caractères
actor.preferredUsername	includes.users.username	expansions=author_id	Chaîne de caractères
actor.postedTime	includes.users.created_at	expansions=author_id&user.fields=created_at	Date (ISO 8601)
actor.summary	includes.users.description	expansions=author_id&user.fields=description	Chaîne de caractères
Non disponible	includes.users.pinned_tweet_id	expansions=author_id&user.fields=pinned_tweet_id	Chaîne de caractères
Non disponible	includes.users.protected	expansions=author_id&user.fields=protected	Booléen
actor.link	Non disponible	Non disponible – à construire à partir de includes.users.username
actor.twitterTimeZone	Non disponible	Non disponible – à déduire à partir de created_at du Tweet
actor.utcOffset	Non disponible	Non disponible – à déduire à partir du champ Tweet.created_at
actor.favoritesCount	Non disponible	Non disponible
actor.followersCount	includes.users.public_metrics.followers_count	expansions=author_id&user.fields=public_metrics	Int
actor.friendsCount	includes.users.public_metrics.following_count	expansions=author_id&user.fields=public_metrics	Int
actor.listedCount	includes.users.public_metrics.listed_count	expansions=author_id&user.fields=public_metrics	Int
actor.statusesCount	includes.users.public_metrics.tweet_count	expansions=author_id&user.fields=public_metrics	Int
actor.languages[]	Non disponible	Non disponible – à déduire à partir du champ Tweet.lang
actor.location.displayName	includes.users.location	expansions=author_id&user.fields=location	String
actor.image	includes.users.profile_image_url	expansions=author_id&user.fields=profile_image_url	String
actor.links	includes.users.url	expansions=author_id&user.fields=url	String
actor.verified	includes.users.verified	expansions=author_id&user.fields=verified	Boolean
Non disponible	includes.users.withheld	expansions=author_id&user.fields=withheld	Objet
Non disponible	includes.users.entities	expansions=author_id&user.fields=entities	Objet
Non disponible	includes.users.entities.url	expansions=author_id&user.fields=entities	Objet
actor.links	includes.users.entities.url.urls	expansions=author_id&user.fields=entities	Tableau d’objets
Non disponible	includes.users.entities.url.urls.start	expansions=author_id&user.fields=entities	Int
Non disponible	includes.users.entities.url.urls.end	expansions=author_id&user.fields=entities	Int
Non disponible	includes.users.entities.url.urls.url	expansions=author_id&user.fields=entities	String
actor.links.href	includes.users.entities.url.urls.expanded_url	expansions=author_id&user.fields=entities	String
Non disponible	includes.users.entities.url.urls.display_url	expansions=author_id&user.fields=entities	String
Non disponible	includes.users.entities.description	expansions=author_id&user.fields=entities	Objet
Non disponible	includes.users.entities.description.hashtags	expansions=author_id&user.fields=entities	Tableau d’objets
Non disponible	includes.users.entities.description.hashtags.start	expansions=author_id&user.fields=entities	Int
Non disponible	includes.users.entities.description.hashtags.end	expansions=author_id&user.fields=entities	Int
Non disponible	includes.users.entities.description.hashtags.tag	expansions=author_id&user.fields=entities	String
Non disponible	includes.users.entities.description.mentions	expansions=author_id&user.fields=entities	Tableau d’objets
Non disponible	includes.users.entities.description.mentions.start	expansions=author_id&user.fields=entities	Int
Non disponible	includes.users.entities.description.mentions.end	expansions=author_id&user.fields=entities	Int
Non disponible	includes.users.entities.description.mentions.username	expansions=author_id&user.fields=entities	String
Non disponible	includes.users.entities.description.cashtags	expansions=author_id&user.fields=entities	Tableau d’objets
Non disponible	includes.users.entities.description.cashtags.start	expansions=author_id&user.fields=entities	Int
Non disponible	includes.users.entities.description.cashtags.end	expansions=author_id&user.fields=entities	Int
Non disponible	includes.users.entities.description.cashtags.tag	expansions=author_id&user.fields=entities	String

​

Objet Poll

Format Activity Streams	Format Twitter v2	Paramètres v2 requis	Type dans v2
Non disponible	includes.polls	expansions=attachments.poll_ids	Tableau d’objets
Non disponible	includes.polls.id	expansions=attachments.poll_ids	Chaîne de caractères
Non disponible	includes.polls.options	expansions=attachments.poll_ids	Tableau d’objets
Non disponible	includes.polls.options.position	expansions=attachments.poll_ids	Entier
Non disponible	includes.polls.options.label	expansions=attachments.poll_ids	Chaîne de caractères
Non disponible	includes.polls.options.votes	expansions=attachments.poll_ids	Entier
Non disponible	includes.polls.voting_status	expansions=attachments.poll_ids&poll.fields=voting_status	Chaîne de caractères
Non disponible	includes.polls.duration_minutes	expansions=attachments.poll_ids&poll.fields=duration_minutes	Entier
Non disponible	includes.polls.end_datetime	expansions=attachments.poll_ids&poll.fields=end_datetime	Date (ISO 8601)

​

Objet Place

Format Activity Streams	Format Twitter v2	Paramètres requis pour v2	Type en v2
location	includes.places	expansions=geo.place_id	array of objects
location.displayName	includes.places.full_name	expansions=geo.place_id	string
Extrait de location.link	includes.places.id	expansions=geo.place_id	string
location.name	includes.places.name	expansions=geo.place_id&place.fields=name	string
location.country_code	includes.places.country	expansions=geo.place_id&place.fields=country	string
location.twitter_place_type	includes.places.place_type	expansions=geo.place_id&place.fields=place_type	string
location.twitter_country_code	includes.places.country_code	expansions=geo.place_id&place.fields=country_code	string
location.geo	includes.places.geo	expansions=geo.place_id&place.fields=geo	object
location.geo.type	includes.places.geo.type	expansions=geo.place_id&place.fields=geo	string
location.geo.coordinates	includes.places.geo.bbox	expansions=geo.place_id&place.fields=geo	array
Non disponible	includes.places.geo.properties	expansions=geo.place_id&place.fields=geo	object

​

Objet média

Format Activity Streams	Format Twitter v2	Paramètres requis pour v2	Type dans v2
twitter_entities.media OR twitter_extended_entities.media	includes.media	expansions=attachments.media_keys	Tableau d’objets
twitter_entities.media.id_str OR twitter_extended_entities.media.id_str	includes.media.media_key	expansions=attachments.media_keys	Chaîne de caractères
twitter_entities.media.id OR twitter_extended_entities.media.id	Non disponible	Non disponible
twitter_entities.media.indices OR twitter_extended_entities.media.indices	Non disponible	Non disponible
twitter_entities.media.additional_media_info OR twitter_extended_entities.media.additional_media_info	Non disponible	Non disponible
twitter_entities.media.additional_media_info.monetizable OR twitter_extended_entities.media.additional_media_info.monetizable	Non disponible	Non disponible
twitter_entities.media.media_url OR twitter_extended_entities.media.media_url	Non disponible	Non disponible
twitter_entities.media.media_url_https OR twitter_extended_entities.media.media_url_https	includes.media.preview_image_url	expansions=attachments.media_keys&media.fields=preview_image_url	Chaîne de caractères
twitter_entities.media.url OR twitter_extended_entities.media.url	Non disponible	Non disponible
twitter_entities.media.display_url OR twitter_extended_entities.media.display_url	Non disponible	Non disponible
twitter_entities.media.expanded_url OR twitter_extended_entities.media.expanded_url	Non disponible	Non disponible
twitter_entities.media.type OR twitter_extended_entities.media.type	includes.media.type	expansions=attachments.media_keys	String
twitter_entities.media.sizes OR twitter_extended_entities.media.sizes	Non disponible	Non disponible
twitter_entities.media.sizes.thumb OR twitter_extended_entities.media.sizes.thumb	Non disponible	Non disponible
twitter_entities.media.sizes.thumb.h OR twitter_extended_entities.media.sizes.thumb.h	Non disponible	Non disponible
twitter_entities.media.sizes.thumb.w OR twitter_extended_entities.media.sizes.thumb.w	Non disponible	Non disponible
twitter_entities.media.sizes.thumb.resize OR twitter_extended_entities.media.sizes.thumb.resize	Non disponible	Non disponible
twitter_entities.media.sizes.small OR twitter_extended_entities.media.sizes.small	Non disponible	Non disponible
twitter_entities.media.sizes.small.h OR twitter_extended_entities.media.sizes.small.h	Non disponible	Non disponible
twitter_entities.media.sizes.small.w OR twitter_extended_entities.media.sizes.small.w	Non disponible	Non disponible
twitter_entities.media.sizes.small.resize OR twitter_extended_entities.media.sizes.small.resize	Non disponible	Non disponible
twitter_entities.media.sizes.medium OR twitter_extended_entities.media.sizes.medium	Non disponible	Non disponible
twitter_entities.media.sizes.medium.h OR twitter_extended_entities.media.sizes.medium.h	Non disponible	Non disponible
twitter_entities.media.sizes.medium.w OR twitter_extended_entities.media.sizes.medium.w	Non disponible	Non disponible
twitter_entities.media.sizes.medium.resize OR twitter_extended_entities.media.sizes.medium.resize	Non disponible	Non disponible
twitter_entities.media.sizes.large OR twitter_extended_entities.media.sizes.large	Non disponible	Non disponible
twitter_entities.media.sizes.large.h OR twitter_extended_entities.media.sizes.large.h	includes.media.height	expansions=attachments.media_keys&media.fields=height	Int
twitter_entities.media.sizes.large.w OR twitter_extended_entities.media.sizes.large.w	includes.media.width	expansions=attachments.media_keys&media.fields=width	Int
twitter_entities.media.sizes.large.resize OR twitter_extended_entities.media.sizes.large.resize	Non disponible	Non disponible
twitter_extended_entities.media.video_info	Non disponible	Non disponible
twitter_extended_entities.media.video_info.aspect_ratio	Non disponible	Non disponible
twitter_extended_entities.media.video_info.duration_millis	includes.media.duration_ms	expansions=attachments.media_keys&media.fields=duration_ms	Int
twitter_extended_entities.media.video_info.variants	Non disponible	Non disponible
twitter_extended_entities.media.video_info.variants.bitrate	Non disponible	Non disponible
twitter_extended_entities.media.video_info.variants.content_type	Non disponible	Non disponible
twitter_extended_entities.media.video_info.variants.url	Non disponible	Non disponible
Non disponible	includes.media.alt_text	expansions=attachments.media_keys&media.fields=alt_text	Chaîne de caractères
Non disponible	includes.media.public_metrics	expansions=attachments.media_keys&media.fields=public_metrics	Objet
Non disponible	includes.media.public_metrics.view_count	expansions=attachments.media_keys&media.fields=public_metrics	Entier
Non disponible	includes.media.non_public_metrics	expansions=attachments.media_keys&media.fields=non_public_metrics	Objet
Non disponible	includes.media.non_public_metrics.playback_0_count	expansions=attachments.media_keys&media.fields=non_public_metrics	Entier
Non disponible	includes.media.non_public_metrics.playback_25_count	expansions=attachments.media_keys&media.fields=non_public_metrics	Entier
Non disponible	includes.media.non_public_metrics.playback_50_count	expansions=attachments.media_keys&media.fields=non_public_metrics	Entier
Non disponible	includes.media.non_public_metrics.playback_75_count	expansions=attachments.media_keys&media.fields=non_public_metrics	Entier
Non disponible	includes.media.non_public_metrics.playback_100_count	expansions=attachments.media_keys&media.fields=non_public_metrics	Entier
Non disponible	includes.media.organic_metrics	expansions=attachments.media_keys&media.fields=organic_metrics	Objet
Non disponible	includes.media.organic_metrics.playback_0_count	expansions=attachments.media_keys&media.fields=organic_metrics	Nombre entier
Non disponible	includes.media.organic_metrics.playback_25_count	expansions=attachments.media_keys&media.fields=organic_metrics	Nombre entier
Non disponible	includes.media.organic_metrics.playback_50_count	expansions=attachments.media_keys&media.fields=organic_metrics	Nombre entier
Non disponible	includes.media.organic_metrics.playback_75_count	expansions=attachments.media_keys&media.fields=organic_metrics	Nombre entier
Non disponible	includes.media.organic_metrics.playback_100_count	expansions=attachments.media_keys&media.fields=organic_metrics	Nombre entier
Non disponible	includes.media.organic_metrics.view_count	expansions=attachments.media_keys&media.fields=organic_metrics	Nombre entier
Non disponible	includes.media.promoted_metrics	expansions=attachments.media_keys&media.fields=promoted_metrics	Objet
Non disponible	includes.media.promoted_metrics.playback_0_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Nombre entier
Non disponible	includes.media.promoted_metrics.playback_25_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Nombre entier
Non disponible	includes.media.promoted_metrics.playback_50_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Nombre entier
Non disponible	includes.media.promoted_metrics.playback_75_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Int
Non disponible	includes.media.promoted_metrics.playback_100_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Int
Non disponible	includes.media.promoted_metrics.view_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Int

​

Objet matching_rules

Format Activity Streams	Format Twitter v2	Paramètres v2 requis	Type dans v2
gnip.matching_rules	matching_rules	Valeur par défaut dans le flux filtré	Tableau d’objets
gnip.matching_rules.tag	matching_rules.tag	Valeur par défaut dans le flux filtré	Chaîne de caractères
gnip.matching_rules.tag.id	Non disponible	Non disponible
gnip.matching_rules.tag.id_str	matching_rules.id	Valeur par défaut dans le flux filtré	Chaîne de caractères

​

Outil visuel de migration de format de données

L’outil visuel de migration de format de données est une application web qui affiche les champs qui font correspondre le format de données X API v1.1 au format X API v2 pour un objet Tweet ou utilisateur donné. Vous pouvez fournir un ID de Tweet ou un ID d’utilisateur à l’application pour voir cette correspondance.

Veuillez noter que vous devrez vous connecter avec votre compte Twitter afin d’utiliser l’application.