> ## Documentation Index > Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Migration du format des données export const Button = ({href, children}) => { return
; };
## 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](https://developer.x.com/en/docs/x-api/v1/data-dictionary/overview), le [format Native Enriched pour l’entreprise](/fr/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary#native-enriched-tweet-object) et le [format Activity Streams pour l’entreprise](/fr/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary#activity-object), 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)](/fr/x-api/migrate/data-format-migration#migrating-from-standard-v1-1s-data-format-to-v2)  * [Native Enriched vers X API v2 (enterprise)](/fr/x-api/migrate/data-format-migration#migrating-from-native-enriched-data-format-to-v2) * [Activity Streams vers X API v2 (enterprise)](/fr/x-api/migrate/data-format-migration#migrating-from-activity-streams-data-format-to-v2) Vous serez peut‑être également intéressé par notre [outil visuel de migration de format de données](/fr/x-api/migrate/data-format-migration#visual-data-format-migration-tool), qui vous aide à voir rapidement les différences entre le [format de données X API v1.1](https://developer.x.com/en/docs/x-api/v1/data-dictionary/overview) et le [format X API v2](/fr/x-api/introduction).
### 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](/fr/x-api/fundamentals/fields) et [expansions](/fr/x-api/fundamentals/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](/fr/x-api/posts/lookup/introduction) 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](/fr/x-api/fundamentals/data-dictionary#tweet) et [utilisateur](/fr/x-api/fundamentals/data-dictionary#user). * 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](/fr/x-api/fundamentals/data-dictionary#tweet), comprenant les éléments suivants : * Un champ [conversation\_id](/fr/x-api/fundamentals/conversation-id) * Deux nouveaux champs [annotations](/fr/x-api/fundamentals/post-annotations), dont context et entities * Plusieurs nouveaux champs [metrics](/fr/x-api/fundamentals/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](/fr/x-api/migrate/data-format-migration). Vous pouvez également être intéressé par notre [outil visuel de migration de format de données](/fr/x-api/migrate/data-format-migration#visual-data-format-migration-tool), qui vous aide à visualiser rapidement les différences entre le [format de données X API v1.1](https://developer.x.com/en/docs/x-api/v1/data-dictionary/overview) et le [format X API v2](/fr/x-api/fundamentals/data-dictionary). Le format de données standard v1.1, également appelé format natif, est le format principal fourni avec les endpoints [standard v1.1](https://developer.x.com/en/docs/twitter-api/v1). Si vous utilisez le produit Premium, veuillez vous référer au [guide sur le format natif enrichi](/fr/x-api/migrate/data-format-migration#migrating-from-native-enriched-data-format-to-v2). 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](/fr/x-api/fundamentals/data-dictionary#how-to-use-fields-and-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](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](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](https://t.co/3cBZKZUevF)",
"truncated": true,
"entities": \{
"hashtags": \[],
"symbols": \[],
"user\_mentions": \[],
"urls": \[\{
"url": "[https://t.co/3cBZKZUevF](https://t.co/3cBZKZUevF)",
"expanded\_url": "[https://twitter.com/i/web/status/1359554366051504129](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](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](https://t.co/mtpd9VIMDa)",
"étendue\_url":"[https://devcommunity.x.com/t/introducing-the-new-manage-follows-endpoints-to-the-twitter-api-v2/149465](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](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](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](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](https://t.co/3ZX3TNiZCY)",
"entities":\{
"url":\{
"urls": \[\{
"url":"[https://t.co/3ZX3TNiZCY](https://t.co/3ZX3TNiZCY)",
"étendue\_url":"[https://developer.x.com/fr/community](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](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](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](http://pbs.twimg.com/profile\_images/1354494203451961345/d8HkZl6p\_normal.jpg)",
"profile\_image\_url\_https":"[https://pbs.twimg.com/profile\_images/1354494203451961345/d8HkZl6p\_normal.jpg](https://pbs.twimg.com/profile\_images/1354494203451961345/d8HkZl6p\_normal.jpg)",
"profil\_banner\_url":"[https://pbs.twimg.com/profile\_banners/2244994945/1611792896](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](https://t.co/3ZX3TNiZCY)",
"expanded\_url": "[https://developer.x.com/en/community](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](https://t.co/3ZX3TNiZCY)",
"profile\_image\_url": "[https://pbs.twimg.com/profile\_images/1354494203451961345/d8HkZl6p\_normal.jpg](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](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](https://t.co/XVLZ3uwikc)",
"étendue\_url":"[https://developer.x.com/en](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](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](https://pbs.twimg.com/ext_tw_video_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg)",
"url":"[https://t.co/dz4oByygWA](https://t.co/dz4oByygWA)",
"display\_url":"pic.x.com/dz4oByygWA",
"étendue\_url":"[https://twitter.com/furiouscamper/status/1370161532013735937/video/1](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](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](https://pbs.twimg.com/ext_tw_video_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg)",
"url":"[https://t.co/dz4oByygWA](https://t.co/dz4oByygWA)",
"display\_url":"pic.x.com/dz4oByygWA",
"étendu\_url":"[https://twitter.com/furiouscamper/status/1370161532013735937/video/1](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](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](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](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](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](https://t.co/XVLZ3uwikc)",
"étendue\_url":"[https://developer.x.com/en](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](https://developer.x.com/en)"
},
\{
"start": 115,
"end": 138,
"url":"[https://t.co/dz4oByygWA](https://t.co/dz4oByygWA)",
"étendue\_url":"[https://x.com/furiouscamper/status/1370161532013735937/video/1](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/XVLZ3uwikc) [https://t.co/dz4oByygWA](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](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](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](https://t.co/3ZX3TNiZCY)",
"étendue\_url":"[https://developer.x.com/fr/community](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](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](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](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/XVLZ3uwikc) [https://t.co/dz4oByygWA](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](/fr/x-api/fundamentals/fields) * En savoir plus sur les [expansions](/fr/x-api/fundamentals/expansions) * Découvrez comment [utiliser les champs avec les expansions](/fr/x-api/fundamentals/data-dictionary#how-to-use-fields-and-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](/fr/x-api/enterprise-gnip-2.0/enterprise-gnip). 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](/fr/x-api/enterprise-gnip-2.0/fundamentals/edit-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](/fr/x-api/migrate/data-format-migration#migrating-from-standard-v1-1s-data-format-to-v2). Si vous utilisez les produits enterprise avec Activity Streams, nous proposons également un guide [Activity Streams vers v2](/fr/x-api/migrate/data-format-migration#migrating-from-activity-streams-data-format-to-v2). X API v2 introduit de nouveaux schémas JSON pour les objets [Tweet](/fr/x-api/fundamentals/data-dictionary#tweet) et [user](/fr/x-api/fundamentals/data-dictionary#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](/fr/x-api/fundamentals/post-annotations), notamment context et entities * Plusieurs nouveaux champs [metrics](/fr/x-api/fundamentals/metrics) * Plusieurs nouveaux champs [polls](/fr/x-api/fundamentals/data-dictionary#poll)   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](/fr/x-api/fundamentals/data-dictionary#how-to-use-fields-and-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](/fr/x-api/enterprise-gnip-2.0/enterprise-gnip). 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](/fr/x-api/enterprise-gnip-2.0/fundamentals/edit-tweets). Si vous utilisez les endpoints standard v1.1, reportez-vous au [guide de migration standard v1.1 vers v2](/fr/x-api/migrate/overview). Si vous utilisez les endpoints premium ou le format Native Enriched pour enterprise, reportez-vous au [guide Native Enriched vers v2](/fr/x-api/migrate/data-format-migration#migrating-from-native-enriched-data-format-to-v2). X API v2 introduit de nouveaux modèles JSON pour les objets [Publication](/fr/x-api/fundamentals/data-dictionary#tweet) et [utilisateur](/fr/x-api/fundamentals/data-dictionary#user). * 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](/fr/x-api/fundamentals/post-annotations), notamment context et entities * Plusieurs nouveaux champs [metrics](/fr/x-api/fundamentals/metrics) * Plusieurs nouveaux champs [polls](/fr/x-api/fundamentals/data-dictionary#poll)   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](https://developer.x.com/en/docs/x-api/v1/data-dictionary/overview) au [format X API v2](/fr/x-api/fundamentals/data-dictionary) 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.