> ## 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. # データ形式の移行 export const Button = ({href, children}) => { return
; };
## はじめに
X API v2 のリリースに伴い、異なるオブジェクトやフィールドをリクエストするための新しいデータレスポンス形式とリクエスト方法を採用しました。これを便宜上「X API v2 フォーマット」と呼びます。  「一般的な違い」のセクションでは、standard ユーザーおよび enterprise ユーザーに関連するいくつかの変更点について学ぶことができます。あわせて、[standard v1.1 の Native フォーマット](https://developer.x.com/en/docs/x-api/v1/data-dictionary/overview)、enterprise 向けの [Native Enriched フォーマット](/ja/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary#native-enriched-tweet-object)、および enterprise 向けの [Activity Streams フォーマット](/ja/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary#activity-object) それぞれに特化したガイドも用意しており、フィールドの対応関係を示すとともに、新しい v2 フィールドをリクエストする際に使用する必要があるフィールドと expansions を説明しています。  * [Native フォーマットから X API v2 へ (standard v1.1)](/ja/x-api/migrate/data-format-migration#migrating-from-standard-v1-1s-data-format-to-v2)  * [Native Enriched から X API v2 へ (enterprise)](/ja/x-api/migrate/data-format-migration#migrating-from-native-enriched-data-format-to-v2) * [Activity Streams から X API v2 へ (enterprise)](/ja/x-api/migrate/data-format-migration#migrating-from-activity-streams-data-format-to-v2) [X API v1.1 データフォーマット](https://developer.x.com/en/docs/x-api/v1/data-dictionary/overview) と [X API v2 フォーマット](/ja/x-api/introduction) の違いをすばやく確認するのに役立つ、[ビジュアルデータフォーマット移行ツール](/ja/x-api/migrate/data-format-migration#visual-data-format-migration-tool) もあわせてご利用いただけます。
### 全般的な違い
#### オブジェクトとフィールドのリクエスト
pre-v2 エンドポイントと v2 の最大の違いの 1 つは、新しいバージョンではデフォルトで返されるフィールドがごく一部に限られているのに対し、Standard、Premium、Enterprise エンドポイントではほとんどのフィールドがデフォルトで返される点です。新しいバージョンでは、[fields](/ja/x-api/fundamentals/fields) と [expansions](/ja/x-api/fundamentals/expansions) というパラメータを使用して、デフォルト以外の追加データを明示的にリクエストします。これにより、不要なフィールドを取り込まずに、必要なデータだけをリクエストできるようになります。  リクエストしたフィールドがプライマリのデータオブジェクトに関連するものであれば、それらはデフォルト値とともに、そのプライマリデータオブジェクト内に返されます。一方で、expansions パラメータを使用して展開対象のオブジェクトをリクエストした場合、セカンダリオブジェクトは新しい includes オブジェクト内に返されます。includes オブジェクト内の展開されたオブジェクトは、両方に含まれる id フィールドを使用することでプライマリオブジェクトと対応付けることができます。 たとえば、v2 の [Post lookup](/ja/x-api/posts/lookup/introduction) エンドポイントを使用し、リクエストに expansions=author\_id パラメータを含めた場合、プライマリのポストオブジェクト内に author\_id フィールドが返されると同時に、includes オブジェクト内にポストごとに 1 つの user オブジェクトが返されます。それぞれの user オブジェクトにはデフォルトの id フィールドが含まれており、このフィールドを使って user オブジェクトをポストオブジェクトと対応付けることができます。以下はその例です。 ``` { "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" } ] } } ```
#### 更新された JSON 設計
特定のフィールドのリクエスト方法の変更に加えて、X API v2 では API から返されるオブジェクト、たとえば [Post](/ja/x-api/fundamentals/data-dictionary#tweet) や [user](/ja/x-api/fundamentals/data-dictionary#user) オブジェクトに対しても、新しい JSON 設計を導入しています。 * JSON のルートレベルでは、従来の標準エンドポイントは Post オブジェクトを **statuses** 配列で返しますが、X API v2 は **data** 配列で返します。  * Retweeted や Quoted の「statuses」を参照する代わりに、X API v2 の JSON では Retweeted および Quoted ツイートを参照します。**contributors** や **user.translator\_type** など、多くのレガシーおよび非推奨フィールドは削除されます。  * Post オブジェクトの **favorites** と user オブジェクトの **favourites** の両方を使用する代わりに、X API v2 では like という用語を使用します。  * X では、値を持たない JSON 値 (たとえば null) はペイロードに含めないという規約を採用しています。Post および user の属性は、null ではない値を持つ場合にのみ含められます。   
#### 新しい v2 フィールド
また、[Post オブジェクト](/ja/x-api/fundamentals/data-dictionary#tweet) に対して、次のような新しいフィールド群も導入しました。 * [conversation\_id](/ja/x-api/fundamentals/conversation-id) フィールド * context と entities を含む、2 つの新しい [annotations](/ja/x-api/fundamentals/post-annotations) フィールド * いくつかの新しい [metrics](/ja/x-api/fundamentals/metrics) フィールド * 新しい reply\_setting フィールド。特定のポストに誰が返信できるかを示すフィールドです
### standard v1.1 のデータフォーマットから v2 への移行
まだお読みでない場合は、まず [データフォーマットの移行](/ja/x-api/migrate/data-format-migration) のイントロダクションに目を通すことをおすすめします。[X API v1.1 のデータフォーマット](https://developer.x.com/en/docs/x-api/v1/data-dictionary/overview) と [X API v2 のフォーマット](/ja/x-api/fundamentals/data-dictionary) の違いをすばやく確認するには、[ビジュアルデータフォーマット移行ツール](/ja/x-api/migrate/data-format-migration#visual-data-format-migration-tool) も参考になるかもしれません。 standard v1.1 データフォーマットはネイティブフォーマットとも呼ばれ、[standard v1.1](https://developer.x.com/en/docs/twitter-api/v1) エンドポイントで提供される主要なフォーマットです。 Premium 製品をご利用の場合は、[ネイティブ拡張データフォーマットガイド](/ja/x-api/migrate/data-format-migration#migrating-from-native-enriched-data-format-to-v2) を参照してください。Enterprise のお客様は、Gnip コンソールでの設定方法に応じて、ネイティブ拡張データまたは activity streams を使用している可能性があります。 
#### 標準 v1.1 と v2 のペイロード構造の比較
次の表では、v1.1 のフォーマットと比較して、v2 から受け取る上位レベルのオブジェクトとフォーマットを示します。 | | **v1.1 structure** | **v2 structure** | | :------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Default** | \{
~~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"
}]
} | | **With defined [field and expansion](/ja/x-api/fundamentals/data-dictionary#how-to-use-fields-and-expansions) parameters** | | \{
"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": \[]
} | **フィールドのマッピング** 次のセクションでは、どの v1.1 のフィールドがどの v2 のフィールドに対応するかに加えて、その新しいフィールドを受け取るために必要な v2 パラメータについて説明します。   #### ツイートオブジェクト | | | | | :----------------------------- | :----------------------------------------------- | :-------------------------------------------------------------------------- | | **Twitter 1.1 format** | **Twitter v2 の形式** | **必須の v2 パラメータ** | | created\_at | data.created\_at | tweet.fields=created\_at | | id | | N/A id は文字列です | | id\_str | data.id | default | | text | data.text | default | | full\_text | | N/A text フィールドにはツイート本文全体が含まれます | | truncated | | N/A text フィールドにはツイート本文全体が含まれます | | display\_text\_range | | N/A text フィールドにはツイート本文全体が含まれます | | edit\_history | data.edit\_history\_tweet\_ids | default | | 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 は文字列です | | in\_reply\_to\_status\_id\_str | data.referenced\_tweets.id (if type=replied\_to) | expansions=referenced\_tweets.id | | in\_reply\_to\_user\_id | | N/A in\_reply\_to\_user\_id は文字列です | | 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 (if type=retweeted) | expansions=referenced\_tweets.id | | is\_quoted\_status | | 利用できません | | quoted\_status\_id | | N/A referenced\_tweets.id は文字列です | | quoted\_status\_id\_str | data.referenced\_tweets.id (if type=quoted) | expansions=referenced\_tweets.id | | quoted\_status\_permalink | | 利用できません | | quoted\_status | data.referenced\_tweets (if 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 | | 利用できません | | retweeted | | 利用できません | | possibly\_sensitive | data.possibly\_sensitive | tweet.fields=possibly\_sensitive | | lang | data.lang | tweet.fields=lang | | scopes | | 利用できません | | withheld | data.withheld | tweet.fields=withheld | **例** | | | | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **1.1 のツイートオブジェクト**

パラメーター付き URI の例:

[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) | **v2 における Tweet オブジェクトとリクエスト**

パラメータ付きの URI の例:

[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\n新しいフォロー管理用エンドポイントを紹介します… [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",
"テキスト":"どうぞ、別の子犬アカウントをフォローしてください。私たちは批判しません。\n\n新しい#TwitterAPIにフォロー管理エンドポイントを導入します。v2 APIを使用してアカウントのフォローとフォロー解除ができるようになりました。詳細はこちら [https://t.co/mtpd9VIMDa](https://t.co/mtpd9VIMDa)",
"lang":"ja",
"スレッド\_id":"1359554366051504129",
"possibly\_sensitive": false,
"リプライ\_設定":"everyone",
"作成日時\_at":"2021-02-10T17:26:34.000Z",
"著者\_id":"2244994945",
"public\_メトリック":\{
"リツイート\_count": 18,
"リプライ\_count": 11,
"like\_count": 98,
"引用ツイート\_count": 7
},
"entities":\{
"hashtags": \[\{
"start": 110,
"end": 121,
"tag":"TwitterAPI"
}],
"urls": \[\{
"start": 194,
"end": 217,
"url":"[https://t.co/mtpd9VIMDa](https://t.co/mtpd9VIMDa)",
"展開後\_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":"X API v2の新しいフォロー管理エンドポイントのご紹介",
"説明":"フォローする、しない?X API v2を使えば、この質問に自由に答えることができます。本日、新しいTwitter APIに新しいフォロー管理エンドポイントをリリースすることを発表いたします。約1か月前にフォロー検索エンドポイントをリリースした際に予告したとおり、フォロー関係を管理する機能がついに登場しました。これらはv1.1 APIで最も人気のあるエンドポイントの一部であり、X API v2で幅広いユースケースを実現できることを嬉しく思います。W\...",
"unwound\_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)"
}]
},
"context\_annotations": \[\{
"domain":\{
"id":"46",
"name":"ブランドカテゴリー",
"説明":"ブランドバーティカル内でブランドの範囲を絞り込むカテゴリ"
},
"entity":\{
"id":"781974596752842752",
"name":"サービス"
}
},
\{
"domain":\{
"id":"47",
"name":"ブランド",
"説明":"ブランドおよび企業"
},
"entity":\{
"id":"10045225402",
"name":"X"
}
}
]
}]
} | ***
#### User オブジェクト
| | | | | :----------------------------------------------- | :---------------------------------------------- | :----------------------------------------------------- | | **Twitter 1.1 の形式** | **Twitter v2 の形式** | **必須の v2 パラメーター** | | user\_id | data.author\_id | tweet.fields=author\_id | | user.id | | N/A。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 | **例** | | | | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **v1.1 の User オブジェクト** | **v2 の User オブジェクトとリクエスト** | | "user":\{
"id": 2244994945,
"id\_str":"2244994945",
"name":"Twitter Dev",
"screen\_name":"TwitterDev",
"location":"127.0.0.1",
"description":"#TwitterDevチームの声であり、#TwitterAPIに関する最新情報、ニュース、イベントの公式情報源です。",
"url":"[https://t.co/3ZX3TNiZCY](https://t.co/3ZX3TNiZCY)",
"entities":\{
"url":\{
"urls": \[\{
"url":"[https://t.co/3ZX3TNiZCY](https://t.co/3ZX3TNiZCY)",
"展開\_url":"[https://developer.x.com/ja/community](https://developer.x.com/ja/community)",
"display\_url":"developer.x.com/ja/community",
"indices": \[
0,
23
]
}]
},
"description":\{
"urls": \[]
}
},
"protected": false,
"フォロワー\_count": 517232,
"friends\_count": 2032,
"リストに登録された\_count": 1722,
"作成日時\_at":"Sat Dec 14 04:35:55 +0000 2013",
"favourites\_count": 2134,
"utc\_offset": null,
"タイムゾーン\_タイムゾーン": null,
"geo\_有効": true,
"認証済み": true,
"ステータス数\_count": 3677,
"lang": null,
"コントリビューター\_有効": false,
"です\_translator": false,
"です\_translation\_有効": false,
"profile\_背景\_color":"FFFFFF",
"profile\_背景\_image\_url":"[http://abs.twimg.com/images/themes/theme1/bg.png](http://abs.twimg.com/images/themes/theme1/bg.png)",
"profile\_背景\_画像\_url\_https":"[https://abs.twimg.com/images/themes/theme1/bg.png](https://abs.twimg.com/images/themes/theme1/bg.png)",
"profile\_背景\_タイル": false,
"profile\_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)",
"profile\_banner\_url":"[https://pbs.twimg.com/profile\_banners/2244994945/1611792896](https://pbs.twimg.com/profile\_banners/2244994945/1611792896)",
"profile\_リンク\_color":"0084B4",
"profile\_サイドバー\_ボーダー\_color":"FFFFFF",
"profile\_サイドバー\_fill\_color":"DDEEF6",
"profile\_text\_color":"333333",
"profile\_使用\_背景\_image": false,
"has\_extended\_profile": true,
"default\_profile": false,
"default\_profile\_画像": false,
"following": null,
"follow\_リクエスト\_送信済み": null,
"notifications": null,
"translator\_type":"regular"
} | \{
"data": \[\{
"author\_id": "2244994945",
"id": "1362876655061073928",
"text": "私たちのリビングルームから皆さんのリビングルームへ 🐱‍💻🛋️ 新しい #TwitterAPI を使い始めるのに役立つ、デベロッパーアドボケートによるエキサイティングな Twitch 配信やオンラインイベントをいくつか予定しています。詳しくはスケジュールをご確認のうえ、もっと見たいという方はぜひお知らせください！\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": "#TwitterDev チームの声であり、#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"
}]
}
} | #### Entities および expanded entities オブジェクト | | | | | | :---------------------------------------------------- | :--------------------------------- | :------------------------------------------------------------------- | :----------- | | **Twitter 1.1 フォーマット** | **Twitter v2 フォーマット** | **必要な v2 パラメータ** | **v2 における型** | | entities | data.entities | tweet.fields=entities | object | | entities.hashtags | data.entities.hashtags | tweet.fields=entities | オブジェクトの配列 | | 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 | オブジェクトの配列 | | 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 | オブジェクトの配列 | | 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 | オブジェクトの配列 | | 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 | オブジェクトの配列 | | 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：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 | オブジェクトの配列 | | extended\_entities.media | includes.media | expansions=attachments.media\_keys | オブジェクトの配列 | | 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 | | 利用不可 | | | extended\_entities.media.sizes.thumb.h | | 利用不可 | | | extended\_entities.media.sizes.thumb.resize | | 利用不可 | | | 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 | | 利用不可 | | | extended\_entities.media.sizes.small.w | | 利用不可 | | | extended\_entities.media.sizes.small.h | | 利用不可 | | | extended\_entities.media.sizes.small.resize | | 利用不可 | | | extended\_entities.media.sizes.medium.w | | 利用不可 | | | extended\_entities.media.sizes.medium.h | | 利用不可 | | | extended\_entities.media.sizes.medium.resize | | 利用不可 | | | 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 | **例** | | | | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **v1.1 における entities および extended\_entities (動画あり) ** | **v2 の entities、attachments、includes**

[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": \[\{
"text":"test",
"indices": \[
8,
13
]
}],
"symbols": \[],
"ユーザー\_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)",
"展開\_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",
"展開\_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",
"展開\_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":\{
"アスペクト比\_アスペクト比": \[
9,
16
],
"duration\_ミリ秒": 5140,
"variants": \[\{
"ビットレート": 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)"
},
\{
"ビットレート": 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)"
},
\{
"ビットレート": 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)"
}
]
},
"追加の\_media\_info":\{
"収益化可能": false
}
}]
} | \{
"data": \[\{
"entities":\{
"hashtags": \[\{
"start": 8,
"end": 13,
"タグ":"test"
}],
"mentions": \[\{
"start": 31,
"end": 42,
"username":"TwitterDev"
}],
"urls": \[\{
"start": 91,
"end": 114,
"url":"[https://t.co/XVLZ3uwikc](https://t.co/XVLZ3uwikc)",
"展開\_url":"[https://developer.x.com/en](https://developer.x.com/en)",
"display\_url":"developer.x.com/ja",
"status": 200,
"title":"ユースケース、チュートリアル、&ドキュメント",
"説明":"投稿&ツイートを分析し、広告を最適化し、\&Twitter API、Twitter Ads APIを使用して独自の顧客体験を創出し、\&Twitter for Websites。's start building.",
"unwound\_url":"[https://developer.x.com/en](https://developer.x.com/en)"
},
\{
"start": 115,
"end": 138,
"url":"[https://t.co/dz4oByygWA](https://t.co/dz4oByygWA)",
"展開\_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",
"text":"動画と@TwitterDevメンションを含む別の#test。新しいフォーマットの移行ドキュメントが楽しみです! [https://t.co/XVLZ3uwikc](https://t.co/XVLZ3uwikc) [https://t.co/dz4oByygWA](https://t.co/dz4oByygWA)",
"添付ファイル":\{
"media\_keys": \[
"7\_1370161464028196868"
]
}
}],
"includes":\{
"media": \[\{
"type":"video",
"height": 1280,
"public\_メトリック":\{
"閲覧\_件数": 37
},
"width": 720,
"media\_key":"7\_1370161464028196868",
"duration\_ms": 5140,
"プレビュー\_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\_メトリック":\{
"フォロワー数\_count": 517233,
"following\_count": 2034,
"ツイート\_件数": 3677,
"リスト登録数\_count": 1727
},
"作成日時\_at":"2013-12-14T04:35:55.000Z",
"profile\_画像\_url":"[https://pbs.twimg.com/profile\_images/1354494203451961345/d8HkZl6p\_normal.jpg](https://pbs.twimg.com/profile_images/1354494203451961345/d8HkZl6p_normal.jpg)",
"説明":"#TwitterDevチームの声であり、#TwitterAPIに関するアップデート、ニュース、イベントの公式情報源です。",
"認証済み": true,
"id":"2244994945",
"username":"TwitterDev",
"protected": false,
"entities":\{
"url":\{
"urls": \[\{
"start": 0,
"end": 23,
"url":"[https://t.co/3ZX3TNiZCY](https://t.co/3ZX3TNiZCY)",
"展開\_url":"[https://developer.x.com/en/community](https://developer.x.com/en/community)",
"display\_url":"developer.x.com/ja/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"
}]
}
} | ***
#### Place オブジェクト
| | | | | :--------------------------------- | :-------------------------------- | :------------------------------------------------------- | | **Twitter 1.1 形式** | **Twitter v2 形式** | **必須の 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 | **例** | | | | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **v1.1 の Place オブジェクト** | **v2 の Place オブジェクト**

[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"
}]
} | **次のステップ** * [フィールド](/ja/x-api/fundamentals/fields)についてさらに学ぶ * [expansions](/ja/x-api/fundamentals/expansions)についてさらに学ぶ * [フィールドと expansions の使い方](/ja/x-api/fundamentals/data-dictionary#how-to-use-fields-and-expansions)を学ぶ
### Native Enriched データ形式から v2 への移行
Native Enriched データ形式は、当社の[エンタープライズ](/ja/x-api/enterprise-gnip-2.0/enterprise-gnip)製品で使用されています。 Native Enriched データ形式は、編集済みツイートのメタデータを提供できるように更新されています。編集ツイートのメタデータの詳細については、[Edit Tweets の基本](/ja/x-api/enterprise-gnip-2.0/fundamentals/edit-tweets)ページを参照してください。 標準の v1.1 エンドポイントを使用している場合は、[standard v1.1 から v2 へのガイド](/ja/x-api/migrate/data-format-migration#migrating-from-standard-v1-1s-data-format-to-v2)を参照してください。Activity Streams を使用するエンタープライズ製品をご利用の場合は、[Activity Streams から v2 への移行](/ja/x-api/migrate/data-format-migration#migrating-from-activity-streams-data-format-to-v2)ガイドも用意しています。 X API v2 では、[ツイート](/ja/x-api/fundamentals/data-dictionary#tweet)オブジェクトと[ユーザー](/ja/x-api/fundamentals/data-dictionary#user)オブジェクトに対して新しい JSON 設計を導入しています。 * JSON のルートレベルでは、Native Enriched 形式は results 配列でツイートオブジェクトを返しますが、X API v2 は data 配列を返します。 * ツイートオブジェクト内の favorites とユーザーオブジェクト内の favourites の両方を使用する代わりに、X API v2 では like という用語を使用します。 * X では、値を持たない JSON 値 (たとえば null) はペイロードに書き込まないという規約を採用しています。ツイートおよびユーザーの属性は、null 以外の値を持つ場合にのみ含まれます。 * v2 のすべての id フィールドは文字列形式になります   新しい JSON 形式に加え、ツイートオブジェクトに対して新しい一連のフィールドも導入しており、以下が含まれます。 * conversation\_id * reply\_settings * メディアの alt\_text * context と entities を含む 2 つの新しい[アノテーション](/ja/x-api/fundamentals/post-annotations)フィールド * 複数の新しい[メトリクス](/ja/x-api/fundamentals/metrics)フィールド * 複数の新しい[投票](/ja/x-api/fundamentals/data-dictionary#poll)フィールド   多くのレガシーおよび非推奨フィールドは削除されます。 * contributors * 特定の entities.media および extended\_entities.media フィールド * filter\_level * timestamp\_ms * truncated
#### Native Enriched と v2 のペイロード構造の比較
次の表は、Native Enriched フォーマットと比較した場合に、v2 から受け取ることが想定される主なオブジェクトとその形式を示しています。 | | **Native Enriched の構造** | **v2 の構造** | | :------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **デフォルト** | \{
~~tweet object fields~~,

"user": {},
"place": {},
"entities": \{
"hashtags": \[],
"urls": \[],
"user\_mentions": \[],
"symbols": \[],
"annotations": \[],
"media": \[]
},
"extended\_entities": {},
"matching\_rules": \[]
} | \{
"data": \[\{
"id",
"text",

"edit\_history\_tweet\_ids"
}]
} | | **[フィールドと expansions](/ja/x-api/fundamentals/data-dictionary#how-to-use-fields-and-expansions) パラメータを指定した場合** | | \{
"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": \[]
} | **フィールドのマッピング** 次のセクションでは、どの Native Enriched のフィールドが v2 のフィールドに対応するか、また新しいフィールドを受け取るためにどの v2 パラメータが必要となるかを説明します。  
#### Tweet オブジェクト
| | | | | | :-------------------------------------------------------- | :----------------------------------------------- | :-------------------------------------------------------------------------- | :------------ | | **Native Enriched データ形式** | **Twitter v2 フォーマット** | **必須となる v2 パラメーター** | **v2 の type** | | created\_at | data.created\_at | tweet.fields=created\_at | 文字列 | | id | | 該当なし (id を参照) | | | id\_str | data.id | デフォルト | 文字列 | | text | data.text | デフォルト | 文字列 | | edit\_history | data.edit\_history\_tweet\_ids | デフォルト | 配列 | | edit\_controls | data.edit\_controls | tweet.fields=edit\_controls | オブジェクト | | editable | data.edit\_controls.is\_edit\_eligible | tweet.fields=edit\_controls | ブール値 | | display\_text\_range | | 該当なし (text には常に完全なテキストが含まれます) | | | source | data.source | tweet.fields=source | 文字列 | | truncated | | 該当なし (text には常に完全なテキストが含まれます) | | | 利用不可 | data.conversation\_id | tweet.fields=conversation\_id | 文字列 | | 利用不可 | data.reply\_settings | tweet.fields=reply\_settings | 文字列 | | in\_reply\_to\_status\_id | | 該当フィールドなし - referenced\_tweets.id を参照 | | | in\_reply\_to\_status\_id\_str | data.referenced\_tweets.id (if type=replied\_to) | expansions=referenced\_tweets.id | 文字列 | | in\_reply\_to\_user\_id | | 該当フィールドなし - 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 | 文字列 | | 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 | オブジェクト | | user.id\_str | data.author\_id | tweet.fields=author\_id | 文字列 | | 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 (if type=quoted) | tweet.fields=referenced\_tweets | 文字列 | | extended\_tweet.full\_text | | 該当なし (テキスト全体が本文です) | | | 利用不可 | data.public\_metrics | tweet.fields=public\_metrics | オブジェクト | | 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 | | 利用不可 | data.non\_public\_metrics | tweet.fields=non\_public\_metrics | オブジェクト | | 利用不可 | data.non\_public\_metrics.impression\_count | tweet.fields=non\_public\_metrics | Int | | 利用不可 | data.non\_public\_metrics.url\_link\_count | tweet.fields=non\_public\_metrics | Int | | 利用不可 | data.non\_public\_metrics.user\_profile\_count | tweet.fields=non\_public\_metrics | Int | | 利用不可 | data.organic\_metrics | tweet.fields=organic\_metrics | オブジェクト | | 利用不可 | data.organic\_metrics.like\_count | tweet.fields=organic\_metrics | 整数 | | 利用不可 | data.organic\_metrics.retweet\_count | tweet.fields=organic\_metrics | 整数 | | 利用不可 | data.organic\_metrics.reply\_count | tweet.fields=organic\_metrics | 整数 | | 利用不可 | data.organic\_metrics.impression\_count | tweet.fields=organic\_metrics | 整数 | | 利用不可 | data.organic\_metrics.url\_link\_count | tweet.fields=organic\_metrics | 整数 | | 利用不可 | data.organic\_metrics.user\_profile\_count | tweet.fields=organic\_metrics | 整数 | | 利用不可 | data.promoted\_metrics | tweet.fields=promoted\_metrics | オブジェクト | | 利用不可 | data.promoted\_metrics.like\_count | tweet.fields=promoted\_metrics | 整数 | | 利用不可 | data.promoted\_metrics.retweet\_count | tweet.fields=promoted\_metrics | 整数 | | 利用不可 | data.promoted\_metrics.reply\_count | tweet.fields=promoted\_metrics | Int | | なし | data.promoted\_metrics.impression\_count | tweet.fields=promoted\_metrics | Int | | なし | data.promoted\_metrics.url\_link\_count | tweet.fields=promoted\_metrics | Int | | なし | data.promoted\_metrics.user\_profile\_count | tweet.fields=promoted\_metrics | Int | | contributors | なし | なし | | | 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 | オブジェクトの配列 | | entities.annotations | | tweet.fields=entities,context\_annotations | オブジェクト | | entities.annotations.context | data.context\_annotations | tweet.fields=entities,context\_annotations | オブジェクトの配列 | | 該当なし | data.context\_annotations.domain | tweet.fields=context\_annotations | オブジェクト | | entities.annotations.context.context\_domain\_id\_str | data.context\_annotations.domain.id | tweet.fields=context\_annotations | 文字列 | | entities.annotations.context.context\_domain\_id | 利用不可 | 利用不可 - 文字列形式については data.context\_annotations.domain.id を参照してください | | | entities.annotations.context.context\_domain\_name | data.context\_annotations.domain.name | tweet.fields=context\_annotations | 文字列 | | entities.annotations.context.context\_domain\_description | data.context\_annotations.domain.description | tweet.fields=context\_annotations | 文字列 | | 該当なし | data.context\_annotations.entity | tweet.fields=context\_annotations | オブジェクト | | entities.annotations.context.context\_entity\_id\_str | data.context\_annotations.entity.id | tweet.fields=context\_annotations | 文字列 | | entities.annotations.context.context\_entity\_id | 利用不可 | 利用不可 - 文字列形式については data.context\_annotations.entity.id を参照してください | | | entities.annotations.context.context\_entity\_name | data.context\_annotations.entity.name | tweet.fields=context\_annotations | 文字列 | | entities.annotations.context.context\_entity\_description | data.context\_annotations.entity.description | tweet.fields=context\_annotations | 文字列 | | entities.annotations.entity | data.entities.annotations | tweet.fields=entities,context\_annotations | オブジェクトの配列 | | extended\_entities | data.attachments | tweet.fields=attachments | オブジェクト | | favorited | 利用不可 | 利用不可 | | | retweeted | 利用不可 | 利用不可 | | | retweeted\_status | | | | | possibly\_sensitive | data.possibly\_sensitive | tweet.fields=possibly\_sensitive | 真偽値 | | lang | data.lang | tweet.fields=lang | 文字列 | | filter\_level | 利用不可 | 利用不可 | | | scopes | 利用不可 | 利用不可 | | | timestamp\_ms | 利用不可 | 利用不可 | | | withheld | data.withheld | tweet.fields=withheld | オブジェクトの配列 | | matching\_rules | matching\_rules | | オブジェクトの配列 | | matching\_rules.id | 使用不可 | 使用不可 | | | matching\_rules.id\_str | matching\_rules.id | フィルタ済みストリームのデフォルト | 文字列 | | matching\_rules.tag | matching\_rules.tag | フィルタ済みストリームのデフォルト | 文字列 |
#### User オブジェクト
| | | | | | :------------------------------------------ | :----------------------------------------------------- | :----------------------------------------------------- | :------------ | | **Native Enriched データ形式** | **Twitter v2 形式** | **v2 で必須のパラメータ** | **v2 の type** | | user | includes.users | expansions=author\_id | オブジェクトの配列 | | user.id | 利用不可 | 該当なし (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 | 文字列 | | 利用不可 | includes.users.url | expansions=author\_id\&user.fields=url | 文字列 | | 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 | Int | | user.created\_at | includes.users.created\_at | expansions=author\_id\&user.fields=created\_at | String | | user.favourites\_count | | まだ利用できません | | | user.verified | includes.users.verified | expansions=author\_id\&user.fields=verified | Boolean | | 利用できません | includes.users.pinned\_tweet\_id | expansions=author\_id\&user.fields=pinned\_tweet\_id | String | | user.statuses\_count | includes.users.public\_metrics.tweet\_count | expansions=author\_id\&user.fields=public\_metrics | Int | | user.profile\_image\_url\_https | includes.users.profile\_image\_url | expansions=author\_id\&user.fields=profile\_image\_url | String | | user.translator\_type | 利用できません | 利用できません | | | user.utc\_offset | 利用できません | 利用できません | | | user.time\_zone | 利用できません | 利用できません | | | user.geo\_enabled | 利用できません | 利用できません | | | user.lang | 利用できません | 利用できません (ツイートの言語から推定) | | | user.contributors\_enabled | 利用できません | 利用できません | | | user.is\_translator | 利用できません | 利用できません | | | user.profile\_background\_color | 利用できません | 利用できません | | | user.profile\_background\_image\_url | 利用できません | 利用できません | | | user.profile\_background\_image\_url\_https | 利用できません | 利用できません | | | user.profile\_background\_title | 利用できません | 利用できません | | | user.profile\_sidebar\_border\_color | 利用できません | 利用できません | | | user.profile\_sidebar\_fill\_color | 利用できません | 利用できません | | | user.profile\_text\_color | 利用できません | 利用できません | | | user.profile\_user\_background\_image | 利用できません | 利用できません | | | user.profile\_image\_url | | includes.user.profile\_image\_url を参照 | | | user.default\_profile | 利用できません | 利用できません | | | user.default\_profile\_image | 利用できません | 利用できません | | | user.following | 利用不可 | 利用不可 | | | user.follow\_request\_sent | 利用不可 | 利用不可 | | | user.notifications | 利用不可 | 利用不可 | | | user.withheld\_in\_countries | includes.users.withheld | expansions=author\_id\&user.fields=withheld | オブジェクト | | user.protected | includes.users.protected | expansions=author\_id\&user.fields=protected | ブール値 | | 利用不可 | includes.users.entities | expansions=author\_id\&user.fields=entities | オブジェクト | | 利用不可 | includes.users.entities.url | expansions=author\_id\&user.fields=entities | オブジェクト | | 利用不可 | includes.users.entities.url.urls | expansions=author\_id\&user.fields=entities | オブジェクトの配列 | | 利用不可 | includes.users.entities.url.urls.start | expansions=author\_id\&user.fields=entities | 整数 | | 利用不可 | includes.users.entities.url.urls.end | expansions=author\_id\&user.fields=entities | 整数 | | 利用不可 | includes.users.entities.url.urls.url | expansions=author\_id\&user.fields=entities | 文字列 | | user.url | includes.users.entities.url.urls.expanded\_url | expansions=author\_id\&user.fields=entities | 文字列 | | 該当なし | includes.users.entities.url.urls.display\_url | expansions=author\_id\&user.fields=entities | 文字列 | | 該当なし | includes.users.entities.descriptions | expansions=author\_id\&user.fields=entities | オブジェクト | | 該当なし | includes.users.entities.descriptions.hashtags | expansions=author\_id\&user.fields=entities | オブジェクトの配列 | | 該当なし | includes.users.entities.descriptions.hashtags.start | expansions=author\_id\&user.fields=entities | 整数 | | 該当なし | includes.users.entities.descriptions.hashtags.end | expansions=author\_id\&user.fields=entities | 整数 | | user.description 内に含まれる | includes.users.entities.descriptions.hashtags.tag | expansions=author\_id\&user.fields=entities | 文字列 | | 該当なし | includes.users.entities.descriptions.mentions | expansions=author\_id\&user.fields=entities | オブジェクトの配列 | | 該当なし | includes.users.entities.descriptions.mentions.start | expansions=author\_id\&user.fields=entities | 整数 | | 該当なし | includes.users.entities.descriptions.mentions.end | expansions=author\_id\&user.fields=entities | 整数 | | user.description に含まれる値 | includes.users.entities.descriptions.mentions.username | expansions=author\_id\&user.fields=entities | 文字列 | | 利用不可 | includes.users.entities.descriptions.cashtags | expansions=author\_id\&user.fields=entities | オブジェクトの配列 | | 利用不可 | includes.users.entities.descriptions.cashtags.start | expansions=author\_id\&user.fields=entities | 整数 | | 利用不可 | includes.users.entities.descriptions.cashtags.end | expansions=author\_id\&user.fields=entities | 整数 | | user.description に含まれる値 | includes.users.entities.descriptions.cashtags.tag | expansions=author\_id\&user.fields=entities | 文字列 |
#### Entities オブジェクトと expanded\_entities オブジェクト
| | | | | | :----------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------- | :-------------------------------------------------------------------- | :--------------- | | **Native Enriched 形式** | **Twitter v2 フォーマット** | **v2 で必須のパラメーター** | **v2 における type** | | entities | data.entities | tweet.fields=entities | オブジェクト | | entities.hashtags | data.entities.hashtags | tweet.fields=entities | オブジェクトの配列 | | entities.hashtags.indices\[0] | data.entities.hashtags.start | tweet.fields=entities | 整数 | | entities.hashtags.indices\[1] | data.entities.hashtags.end | tweet.fields=entities | 整数 | | entities.hashtags.text | data.entities.hashtags.tag | tweet.fields=entities | 文字列 | | entities.urls | data.entities.urls | tweet.fields=entities | オブジェクトの配列 | | entities.urls.indices\[0] | data.entities.urls.start | tweet.fields=entities | 整数 | | entities.urls.indices\[1] | data.entities.urls.end | tweet.fields=entities | 整数 | | entities.urls.url | data.entities.urls.url | tweet.fields=entities | 文字列 | | entities.urls.expanded\_url | data.entities.urls.expanded\_url | tweet.fields=entities | 文字列 | | 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 | | 該当なし | data.entities.urls.images | tweet.fields=entities | オブジェクトの配列 | | 該当なし | data.entities.urls.images.url | tweet.fields=entities | String | | 該当なし | data.entities.urls.images.width | tweet.fields=entities | Int | | 該当なし | data.entities.urls.images.height | tweet.fields=entities | Int | | entities.user\_mentions | data.entities.mentions | tweet.fields=entities | オブジェクトの配列 | | entities.user\_mentions.indicies\[0] | data.entities.mentions.start | tweet.fields=entities | 整数 | | entities.user\_mentions.indicies\[1] | data.entities.mentions.end | tweet.fields=entities | 整数 | | entities.user\_mentions.screen\_name | data.entities.mentions.username | tweet.fields=entities | 文字列 | | entities.symbols | data.entities.cashtags | tweet.fields=entities | オブジェクトの配列 | | entities.symbols.indices\[0] | data.entities.cashtags.start | tweet.fields=entities | 整数 | | entities.symbols.indices\[1] | data.entities.cashtags.end | tweet.fields=entities | 整数 | | entities.symbols.text | data.entities.cashtags.tag | tweet.fields=entities | 文字列 | | entities.media OR extended\_entities.media | includes.media | expansions=attachments.media\_keys | オブジェクトの配列 | | entities.media.id\_str OR extended\_entities.media.id\_str | includes.media.media\_key | expansions=attachments.media\_keys | 文字列 | | entities.media.id OR extended\_entities.media.id | | 利用できません (id は文字列です) | | | entities.media.type OR extended\_entities.media.type | includes.media.media.type | expansions=attachments.media\_keys | 文字列 | | entities.media.indices OR extended\_entities.media.indices | 利用不可 | 利用不可 | | | 利用不可 | includes.media.alt\_text | expansions=attachments.media\_keys\&media.fields=alt\_text | 文字列 | | entities.media.additional\_media\_info OR extended\_entities.media.additional\_media\_info | 利用不可 | 利用不可 | | | entities.media.additional\_media\_info.monetizable OR extended\_entities.media.additional\_media\_info.monetizable | 利用不可 | 利用不可 | | | entities.media.media\_url OR extended\_entities.media.media\_url | | 該当なし (includes.media.url を参照) | 文字列 | | entities.media.media\_url\_https OR extended\_entities.media.media\_url\_https | includes.media.url | expansions=attachments.media\_keys\&media.fields=url | 文字列 | | 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 | 文字列 | | extended\_entities | data.attachments | tweet\_fields=attachments | オブジェクト | | extended\_entities | data.attachments.media\_keys | tweet.fields=attachments | オブジェクトの配列 | | 利用不可 | data.attachments.poll\_ids | tweet.fields=attachments | オブジェクトの配列 | | extended\_entities.media.sizes.thumb.w | | 利用不可 | | | extended\_entities.media.sizes.thumb.h | | 利用不可 | | | extended\_entities.media.sizes.thumb.resize | | 利用不可 | | | 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 | 利用不可 | 利用不可 | | | extended\_entities.media.sizes.small.w | 利用不可 | 利用不可 | | | extended\_entities.media.sizes.small.h | 利用不可 | 利用不可 | | | extended\_entities.media.sizes.small.resize | 利用不可 | 利用不可 | | | extended\_entities.media.sizes.medium.w | 利用不可 | 利用不可 | | | extended\_entities.media.sizes.medium.h | 利用不可 | 利用不可 | | | extended\_entities.media.sizes.medium.resize | 利用不可 | 利用不可 | | | extended\_entities.media.media\_url\_https | includes.media.preview\_image\_url | expansions=attachments.media\_keys\&media.fields=preview\_image\_url | 文字列 | | extended\_entities.media.video\_info.aspect\_ratio | 利用不可 | 該当なし | | | extended\_entities.media.variants | 該当なし | 該当なし | | | extended\_entities.media.variants.bitrate | 該当なし | 該当なし | | | extended\_entities.media.variants.content\_type | 該当なし | 該当なし | | | extended\_entities.media.variants.url | 該当なし | 該当なし | | | extended\_entities.media.video\_info.duration\_millis | includes.media.duration\_ms | expansions=attachments.media\_keys\&media.fields=duration\_ms | Int | | 該当なし | includes.media.public\_metrics | expansions=attachments.media\_keys\&media.fields=public\_metrics | Object | | 該当なし | includes.media.public\_metrics.view\_count | expansions=attachments.media\_keys\&media.fields=public\_metrics | Int | | 該当なし | includes.media.non\_public\_metrics | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | Object | | 該当なし | includes.media.non\_public\_metrics.playback\_0\_count | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | Int | | 該当なし | includes.media.non\_public\_metrics.playback\_25\_count | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | Int | | 該当なし | includes.media.non\_public\_metrics.playback\_50\_count | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | Int | | 該当なし | includes.media.non\_public\_metrics.playback\_75\_count | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | Int | | 該当なし | includes.media.non\_public\_metrics.playback\_100\_count | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | Int | | 該当なし | includes.media.organic\_metrics | expansions=attachments.media\_keys\&media.fields=organic\_metrics | Object | | 該当なし | includes.media.organic\_metrics.playback\_0\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | Int | | 該当なし | includes.media.organic\_metrics.playback\_25\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | Int | | 該当なし | includes.media.organic\_metrics.playback\_50\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | Int | | 該当なし | includes.media.organic\_metrics.playback\_75\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | Int | | 該当なし | includes.media.organic\_metrics.playback\_100\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | Int | | 該当なし | includes.media.organic\_metrics.view\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | Int | | 該当なし | includes.media.promoted\_metric | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | オブジェクト | | 該当なし | includes.media.promoted\_metric.playback\_0\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | 整数 | | 該当なし | includes.media.promoted\_metric.playback\_25\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | 整数 | | 該当なし | includes.media.promoted\_metric.playback\_50\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | 整数 | | 該当なし | includes.media.promoted\_metric.playback\_75\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | 整数 | | 該当なし | includes.media.promoted\_metric.playback\_100\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | 整数 | | 該当なし | includes.media.promoted\_metrics.view\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | 整数 |
#### Place オブジェクト
| | | | | | :--------------------------------- | :-------------------------------- | :------------------------------------------------------- | :--------- | | **Native Enriched 形式** | **Twitter v2 形式** | **必須の v2 パラメータ** | **v2 での型** | | place | includes.places | expansions=geo.place\_id | オブジェクトの配列 | | place.id | includes.places.id | expansions=geo.place\_id | 文字列 | | place.url | 利用不可 | 利用不可 | | | 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 | オブジェクト | #### 投票オブジェクト | | | | | | :------------------------------- | :------------------------------- | :-------------------------------------------------------------- | :------------ | | **ネイティブ Enriched 形式** | **Twitter v2 形式** | **必須の v2 パラメーター** | **v2 における型** | | entities.polls | includes.polls | expansions=attachments.poll\_ids | オブジェクトの配列 | | なし | includes.polls.id | expansions=attachments.poll\_ids | String | | entities.poll.options | includes.polls.options | expansions=attachments.poll\_ids | オブジェクトの配列 | | entities.polls.options.position | includes.polls.options.position | expansions=attachments.poll\_ids | Int | | entities.polls.options.text | includes.polls.options.label | expansions=attachments.poll\_ids | String | | なし | includes.polls.options.votes | expansions=attachments.poll\_ids | Int | | なし | includes.polls.voting\_status | expansions=attachments.poll\_ids\&poll.fields=voting\_status | String | | entities.polls.duration\_minutes | includes.polls.duration\_minutes | expansions=attachments.poll\_ids\&poll.fields=duration\_minutes | Int | | entities.polls.end\_datetime | includes.polls.end\_datetime | expansions=attachments.poll\_ids\&poll.fields=end\_datetime | 日付 (ISO 8601) |
### Activity Streams データフォーマットから v2 への移行
Activity Streams データフォーマットは、弊社の [エンタープライズ](/ja/x-api/enterprise-gnip-2.0/enterprise-gnip)製品で利用可能です。 Activity Streams データフォーマットは、編集されたツイートのメタデータを提供できるように更新されました。ツイート編集のメタデータの詳細については、[Edit Tweets の基本](/ja/x-api/enterprise-gnip-2.0/fundamentals/edit-tweets)ページを参照してください。 標準の v1.1 エンドポイントを使用している場合は、[standard v1.1 から v2 へのガイド](/ja/x-api/migrate/overview)を参照してください。Premium エンドポイントやエンタープライズ向けの Native Enriched フォーマットを使用している場合は、[Native Enriched から v2 へのガイド](/ja/x-api/migrate/data-format-migration#migrating-from-native-enriched-data-format-to-v2)を参照してください。 X API v2 では、[ポスト](/ja/x-api/fundamentals/data-dictionary#tweet)および[ユーザー](/ja/x-api/fundamentals/data-dictionary#user)オブジェクトに対して新しい JSON 設計が導入されています。 * JSON のルートレベルでは、Activity Streams フォーマットは results 配列内にツイートオブジェクトを返しますが、X API v2 は data 配列を返します。  * リツイートおよび引用の「activities」を参照する代わりに、X API v2 の JSON ではリツイートおよび引用ツイートを参照します。  * ツイートオブジェクト内の favorites とユーザーオブジェクト内の favourites を両方使用する代わりに、X API v2 では like という用語を使用します。  * Twitter では、値を持たない JSON 値 (たとえば null) はペイロードに書き出さないという規約を採用しています。ツイートおよびユーザー属性は、null 以外の値を持っている場合にのみ含まれます。  * v2 のすべての id フィールドは文字列形式になります。   新しい JSON フォーマットへの変更に加えて、ツイートオブジェクトには次のような新しいフィールドセットも導入されています。 * conversation\_id * reply\_settings * メディア上の alt\_text * context と entities を含む 2 つの新しい [annotations](/ja/x-api/fundamentals/post-annotations) フィールド * 複数の新しい [metrics](/ja/x-api/fundamentals/metrics) フィールド * 複数の新しい [polls](/ja/x-api/fundamentals/data-dictionary#poll) フィールド   多くのレガシーおよび非推奨フィールドは削除または置き換えられます。 * display\_text\_range * generator * gnip * link * objectType * provider * twitter\_entities.symbols は data.entities.cashtags に置き換え * 一部の twitter\_extended\_entities.media および twitter\_entities.media フィールド * twitter\_filter\_level * twitterTimeZone * verb #### ツイートオブジェクト | | | | | | :-------------------------------------------- | :--------------------------------------------- | :----------------------------------- | :--------------- | | **Activity Streams フォーマット** | **Twitter v2 形式** | **必須の v2 パラメータ** | **v2 における type** | | postedTime | data.created\_at | tweet.fields=created\_at | 日付 (ISO 8601) | | generator | 利用不可 | 利用不可 | | | generator.link | 利用不可 | 利用不可 | | | generator.displayName | data.source | tweet.fields=source | 文字列 | | twitter\_lang | data.lang | tweet.fields=lang | 文字列 | | 利用不可 | data.conversation\_id | tweet.fields=conversation\_id | 文字列 | | 利用不可 | data.reply\_settings | tweet.fields=reply\_settings | 文字列 | | 利用不可 | data.possibly\_sensitive | tweet.fields=possibly\_sensitive | ブール値 | | 利用不可 | data.withheld | tweet.fields=withheld | オブジェクト | | objectType | 利用不可 | 利用不可 | | | verb | 利用不可 | 利用不可 | | | プロバイダー | 該当なし | 該当なし | | | provider.objectType | 該当なし | 該当なし | | | provider.displayName | 該当なし | 該当なし | | | provider.link | 該当なし | 該当なし | | | リンク | 該当なし | 該当なし | | | display\_text\_range | 該当なし | 該当なし | | | オブジェクト | 該当なし | 該当なし | | | object.objectType | 該当なし | 該当なし | | | object.id | 該当なし | 該当なし | | | object.summary | data.text | 既定値 | String | | object.edit\_history | data.edit\_history\_tweet\_ids | 既定値 | Array | | object.edit\_controls | data.edit\_controls | tweet.fields=edit\_controls | Object | | object.editable | data.edit\_controls.is\_edit\_eligible | tweet.fields=edit\_controls | ブール値 | | object.link | 利用不可 | 利用不可 | | | object.postedTime | data.created\_at | tweet.fields=created\_at | 日付 (ISO 8601) | | actor.id から導出 | data.author\_id | tweet.fields=author\_id | | | twitter\_filter\_level | 利用不可 | 利用不可 | | | inReplyTo.link 内のユーザー名から導出 | data.in\_reply\_to\_user\_id | tweet.fields=in\_reply\_to\_user\_id | 文字列 | | 利用不可 | data.referenced\_tweets | tweet.fields=referenced\_tweets | オブジェクトの配列 | | 利用不可 | data.referenced\_tweets.type | tweet.fields=referenced\_tweets | 文字列 | | inReplyTo.link から導出 | data.referenced\_tweets.id | tweet.fields=referenced\_tweets | 文字列 | | 利用不可 | data.attachments | tweet.fields=attachments | オブジェクト | | twitter\_entities.media.id\_str から導出 | data.attachments.media\_keys | tweet.fields=attachments | 配列 | | 該当なし | data.attachments.poll\_ids | tweet.fields=attachments | 配列 | | twitter\_entities | data.entities | tweet.fields=entities | オブジェクト | | 該当なし | data.entities.annotations | tweet.fields=entities | オブジェクトの配列 | | 該当なし | data.entities.annotations.start | tweet.fields=entities | Int | | 該当なし | data.entities.annotations.end | tweet.fields=entities | Int | | 該当なし | data.entities.annotations.probability | tweet.fields=entities | Float | | 該当なし | data.entities.annotations.type | tweet.fields=entities | String | | 該当なし | data.entities.annotations.normalized\_text | tweet.fields=entities | String | | twitter\_entities.urls | data.entities.urls | tweet.fields=entities | オブジェクトの配列 | | twitter\_entities.urls.indices\[0] | data.entities.urls.start | tweet.fields=entities | Int | | twitter\_entities.urls.indices\[1] | data.entities.urls.end | tweet.fields=entities | 整数 | | twitter\_entities.urls.url | data.entities.urls.url | tweet.fields=entities | 文字列 | | twitter\_entities.urls.expanded\_url | data.entities.urls.expanded\_url | tweet.fields=entities | 文字列 | | twitter\_entities.urls.display\_url | data.entities.urls.display\_url | tweet.fields=entities | 文字列 | | 使用不可 | data.entities.urls.images | tweet.fields=entities | オブジェクトの配列 | | 使用不可 | data.entities.urls.images.url | tweet.fields=entities | 文字列 | | 使用不可 | data.entities.urls.images.width | tweet.fields=entities | 整数 | | 使用不可 | data.entities.urls.images.height | tweet.fields=entities | 整数 | | gnip.urls.expanded\_status | data.entities.urls.status | tweet.fields=entities | 整数 | | gnip.urls.expanded\_url\_title | data.entities.urls.title | tweet.fields=entities | 文字列 | | gnip.urls.expanded\_url\_description | data.entities.urls.description | tweet.fields=entities | 文字列 | | gnip.urls.expanded\_url | data.entities.urls.unwound\_url | tweet.fields=entities | 文字列 | | twitter\_entities.symbols | data.entities.cashtags | tweet.fields=entities | オブジェクトの配列 | | twitter\_entities.symbols.indices\[0] | data.entities.cashtags.start | tweet.fields=entities | 整数 | | twitter\_entities.symbols.indices\[1] | data.entities.cashtags.end | tweet.fields=entities | 整数 | | twitter\_entities.symbols.text | data.entities.cashtags.tag | tweet.fields=entities | 文字列 | | twitter\_entities.hashtags | data.entities.hashtags | tweet.fields=entities | オブジェクトの配列 | | twitter\_entities.hashtags.indices\[0] | data.entities.hashtags.start | tweet.fields=entities | 整数 | | twitter\_entities.hashtags.indices\[1] | data.entities.hashtags.end | tweet.fields=entities | 整数 | | twitter\_entities.hashtags.text | data.entities.hashtags.tag | tweet.fields=entities | 文字列 | | twitter\_entities.user\_mentions | data.entities.mentions | tweet.fields=entities | オブジェクトの配列 | | 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 | 利用不可 | 利用不可 | | | 利用不可 | data.context\_annotations | tweet.fields=context\_annotations | オブジェクトの配列 | | 利用不可 | data.context\_annotations.domain | tweet.fields=context\_annotations | オブジェクト | | 利用不可 | data.context\_annotations.domain.id | tweet.fields=context\_annotations | 文字列 (String) | | 利用不可 | data.context\_annotations.domain.name | tweet.fields=context\_annotations | 文字列 (String) | | 利用不可 | data.context\_annotations.domain.description | tweet.fields=context\_annotations | String | | 利用不可 | data.context\_annotations.entity | tweet.fields=context\_annotations | Object | | 利用不可 | data.context\_annotations.entity.id | tweet.fields=context\_annotations | String | | 利用不可 | data.context\_annotations.entity.name | tweet.fields=context\_annotations | String | | 利用不可 | data.context\_annotations.entity.description | tweet.fields=context\_annotations | String | | geo | data.geo | tweet.fields=geo | Object | | location.link から導出される値 | data.geo.place\_id | tweet.fields=geo | String | | 利用不可 | data.public\_metrics | tweet.fields=public\_metrics | Object | | favoritesCount | data.public\_metrics.like\_count | tweet.fields=public\_metrics | Int | | retweetCount | data.public\_metrics.retweet\_count | tweet.fields=public\_metrics | Int | | 利用不可 | data.public\_metrics.quote\_count | tweet.fields=public\_metrics | Int | | 該当なし | data.public\_metrics.reply\_count | tweet.fields=public\_metrics | Int | | 該当なし | data.non\_public\_metrics | tweet.fields=non\_public\_metrics | Object | | 該当なし | data.non\_public\_metrics.impression\_count | tweet.fields=non\_public\_metrics | Int | | 該当なし | data.non\_public\_metrics.url\_link\_count | tweet.fields=non\_public\_metrics | Int | | 該当なし | data.non\_public\_metrics.user\_profile\_count | tweet.fields=non\_public\_metrics | Int | | 該当なし | data.organic\_metrics | tweet.fields=organic\_metrics | Object | | 該当なし | data.organic\_metrics.like\_count | tweet.fields=organic\_metrics | Int | | 該当なし | data.organic\_metrics.retweet\_count | tweet.fields=organic\_metrics | Int | | 該当なし | data.organic\_metrics.reply\_count | tweet.fields=organic\_metrics | Int | | 該当なし | data.organic\_metrics.impression\_count | tweet.fields=organic\_metrics | Int | | 利用不可 | data.organic\_metrics.url\_link\_count | tweet.fields=organic\_metrics | Int | | 利用不可 | data.organic\_metrics.user\_profile\_count | tweet.fields=organic\_metrics | Int | | 利用不可 | data.promoted\_metrics | tweet.fields=promoted\_metrics | Object | | 利用不可 | data.promoted\_metrics.like\_count | tweet.fields=promoted\_metrics | Int | | 利用不可 | data.promoted\_metrics.retweet\_count | tweet.fields=promoted\_metrics | Int | | 利用不可 | data.promoted\_metrics.reply\_count | tweet.fields=promoted\_metrics | Int | | 利用不可 | data.promoted\_metrics.impression\_count | tweet.fields=promoted\_metrics | Int | | 利用不可 | data.promoted\_metrics.url\_link\_count | tweet.fields=promoted\_metrics | Int | | 利用不可 | data.promoted\_metrics.user\_profile\_count | tweet.fields=promoted\_metrics | Int | | gnip.profileLocations | 利用不可 | 利用不可 | | | gnip.profileLocations.address | 利用不可 | 利用不可 | | | gnip.profileLocations.address.country | 利用不可 | 利用不可 | | | gnip.profileLocations.address.countryCode | 利用不可 | 利用不可 | | | gnip.profileLocations.displayName | 利用不可 | 利用不可 | | | gnip.profileLocations.geo | 利用不可 | 利用不可 | | | gnip.profileLocations.geo.coordinates | 利用不可 | 利用不可 | | | gnip.profileLocations.geo.type | 利用不可 | 利用不可 | | | gnip.profileLocations.objectType | 利用不可 | 利用不可 | |
#### User オブジェクト
| | | | | | :------------------------- | :---------------------------------------------------- | :----------------------------------------------------- | :--------------- | | **Activity Streams データ形式** | **Twitter v2 フォーマット** | **v2で必須のパラメータ** | **v2 における type** | | actor | includes.users | expansions=author\_id | オブジェクトの配列 | | actor.id から導出される | includes.users.id | expansions=author\_id | 文字列 | | actor.displayName | includes.users.name | expansions=author\_id | 文字列 | | actor.preferredUsername | includes.users.username | expansions=author\_id | 文字列 | | actor.postedTime | includes.users.created\_at | expansions=author\_id\&user.fields=created\_at | 日付 (ISO 8601) | | actor.summary | includes.users.description | expansions=author\_id\&user.fields=description | 文字列 | | 使用不可 | includes.users.pinned\_tweet\_id | expansions=author\_id\&user.fields=pinned\_tweet\_id | 文字列 | | 使用不可 | includes.users.protected | expansions=author\_id\&user.fields=protected | ブール値 | | actor.link | 使用不可 | 使用不可 - includes.users.username から生成 | | | actor.twitterTimeZone | 使用不可 | 使用不可 - Tweet の created\_at から推定 | | | actor.utcOffset | 使用不可 | 利用不可 (ツイートの created\_at から推定) | | | actor.favoritesCount | 利用不可 | 利用不可 | | | 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\[] | 利用不可 | 利用不可 (ツイートの 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 | | 利用不可 | includes.users.withheld | expansions=author\_id\&user.fields=withheld | オブジェクト | | 該当なし | includes.users.entities | expansions=author\_id\&user.fields=entities | オブジェクト | | 該当なし | includes.users.entities.url | expansions=author\_id\&user.fields=entities | オブジェクト | | actor.links | includes.users.entities.url.urls | expansions=author\_id\&user.fields=entities | オブジェクトの配列 | | 該当なし | includes.users.entities.url.urls.start | expansions=author\_id\&user.fields=entities | Int | | 該当なし | includes.users.entities.url.urls.end | expansions=author\_id\&user.fields=entities | Int | | 該当なし | includes.users.entities.url.urls.url | expansions=author\_id\&user.fields=entities | 文字列 | | actor.links.href | includes.users.entities.url.urls.expanded\_url | expansions=author\_id\&user.fields=entities | 文字列 | | 該当なし | includes.users.entities.url.urls.display\_url | expansions=author\_id\&user.fields=entities | 文字列 | | 該当なし | includes.users.entities.description | expansions=author\_id\&user.fields=entities | オブジェクト | | 該当なし | includes.users.entities.description.hashtags | expansions=author\_id\&user.fields=entities | オブジェクトの配列 | | 該当なし | includes.users.entities.description.hashtags.start | expansions=author\_id\&user.fields=entities | Int | | 該当なし | includes.users.entities.description.hashtags.end | expansions=author\_id\&user.fields=entities | Int | | 該当なし | includes.users.entities.description.hashtags.tag | expansions=author\_id\&user.fields=entities | String | | 該当なし | includes.users.entities.description.mentions | expansions=author\_id\&user.fields=entities | オブジェクトの配列 | | 該当なし | includes.users.entities.description.mentions.start | expansions=author\_id\&user.fields=entities | Int | | 該当なし | includes.users.entities.description.mentions.end | expansions=author\_id\&user.fields=entities | Int | | 該当なし | includes.users.entities.description.mentions.username | expansions=author\_id\&user.fields=entities | String | | 該当なし | includes.users.entities.description.cashtags | expansions=author\_id\&user.fields=entities | オブジェクトの配列 | | 該当なし | includes.users.entities.description.cashtags.start | expansions=author\_id\&user.fields=entities | Int | | 該当なし | includes.users.entities.description.cashtags.end | expansions=author\_id\&user.fields=entities | Int | | 利用不可 | includes.users.entities.description.cashtags.tag | expansions=author\_id\&user.fields=entities | String |
#### Poll オブジェクト
| | | | | | :-------------------------- | :------------------------------- | :-------------------------------------------------------------- | :------------ | | **Activity Streams フォーマット** | **Twitter v2 フォーマット** | **必要な v2 パラメータ** | **v2 の型** | | 利用不可 | includes.polls | expansions=attachments.poll\_ids | オブジェクトの配列 | | 利用不可 | includes.polls.id | expansions=attachments.poll\_ids | String | | 利用不可 | includes.polls.options | expansions=attachments.poll\_ids | オブジェクトの配列 | | 利用不可 | includes.polls.options.position | expansions=attachments.poll\_ids | Int | | 利用不可 | includes.polls.options.label | expansions=attachments.poll\_ids | String | | 利用不可 | includes.polls.options.votes | expansions=attachments.poll\_ids | Int | | 利用不可 | includes.polls.voting\_status | expansions=attachments.poll\_ids\&poll.fields=voting\_status | String | | 利用不可 | includes.polls.duration\_minutes | expansions=attachments.poll\_ids\&poll.fields=duration\_minutes | Int | | 利用不可 | includes.polls.end\_datetime | expansions=attachments.poll\_ids\&poll.fields=end\_datetime | 日付 (ISO 8601) |
#### Place オブジェクト
| | | | | | :------------------------------ | :----------------------------- | :--------------------------------------------------- | :----------- | | **Activity Streams 形式** | **Twitter v2 形式** | **必須の v2 パラメーター** | **v2 における型** | | location | includes.places | expansions=geo.place\_id | オブジェクトの配列 | | location.displayName | includes.places.full\_name | expansions=geo.place\_id | string | | Parsed from 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 | | 利用不可 | includes.places.geo.properties | expansions=geo.place\_id\&place.fields=geo | object |
#### メディアオブジェクト
| | | | | | :----------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------- | :-------------------------------------------------------------------- | :------------- | | **Activity Streams データ形式** | **Twitter API v2 フォーマット** | **v2 の必須パラメータ** | **v2 での type** | | twitter\_entities.media OR twitter\_extended\_entities.media | includes.media | expansions=attachments.media\_keys | オブジェクトの配列 | | twitter\_entities.media.id\_str OR twitter\_extended\_entities.media.id\_str | includes.media.media\_key | expansions=attachments.media\_keys | 文字列 | | twitter\_entities.media.id OR twitter\_extended\_entities.media.id | 利用不可 | 利用不可 | | | twitter\_entities.media.indices OR twitter\_extended\_entities.media.indices | 利用不可 | 利用不可 | | | twitter\_entities.media.additional\_media\_info OR twitter\_extended\_entities.media.additional\_media\_info | 利用不可 | 利用不可 | | | twitter\_entities.media.additional\_media\_info.monetizable OR twitter\_extended\_entities.media.additional\_media\_info.monetizable | 利用不可 | 利用不可 | | | twitter\_entities.media.media\_url OR twitter\_extended\_entities.media.media\_url | 利用不可 | 利用不可 | | | 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 | 文字列 | | twitter\_entities.media.url OR twitter\_extended\_entities.media.url | 利用不可 | 利用不可 | | | twitter\_entities.media.display\_url OR twitter\_extended\_entities.media.display\_url | 利用不可 | 利用不可 | | | twitter\_entities.media.expanded\_url OR twitter\_extended\_entities.media.expanded\_url | 利用不可 | 利用不可 | | | twitter\_entities.media.type OR twitter\_extended\_entities.media.type | includes.media.type | expansions=attachments.media\_keys | 文字列 | | twitter\_entities.media.sizes OR twitter\_extended\_entities.media.sizes | 利用不可 | 利用不可 | | | twitter\_entities.media.sizes.thumb OR twitter\_extended\_entities.media.sizes.thumb | 利用不可 | 利用不可 | | | twitter\_entities.media.sizes.thumb.h OR twitter\_extended\_entities.media.sizes.thumb.h | 利用不可 | 利用不可 | | | twitter\_entities.media.sizes.thumb.w OR twitter\_extended\_entities.media.sizes.thumb.w | 利用不可 | 利用不可 | | | twitter\_entities.media.sizes.thumb.resize OR twitter\_extended\_entities.media.sizes.thumb.resize | 利用不可 | 利用不可 | | | twitter\_entities.media.sizes.small OR twitter\_extended\_entities.media.sizes.small | 利用不可 | 利用不可 | | | twitter\_entities.media.sizes.small.h OR twitter\_extended\_entities.media.sizes.small.h | 利用不可 | 利用不可 | | | twitter\_entities.media.sizes.small.w OR twitter\_extended\_entities.media.sizes.small.w | 利用不可 | 利用不可 | | | twitter\_entities.media.sizes.small.resize OR twitter\_extended\_entities.media.sizes.small.resize | 利用不可 | 利用不可 | | | twitter\_entities.media.sizes.medium OR twitter\_extended\_entities.media.sizes.medium | 利用不可 | 利用不可 | | | twitter\_entities.media.sizes.medium.h OR twitter\_extended\_entities.media.sizes.medium.h | 利用不可 | 利用不可 | | | twitter\_entities.media.sizes.medium.w OR twitter\_extended\_entities.media.sizes.medium.w | 利用不可 | 利用不可 | | | twitter\_entities.media.sizes.medium.resize OR twitter\_extended\_entities.media.sizes.medium.resize | 利用できません | 利用できません | | | twitter\_entities.media.sizes.large OR twitter\_extended\_entities.media.sizes.large | 利用できません | 利用できません | | | 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 | 利用できません | 利用できません | | | twitter\_extended\_entities.media.video\_info | 利用できません | 利用できません | | | twitter\_extended\_entities.media.video\_info.aspect\_ratio | 利用できません | 利用できません | | | 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 | 利用できません | 利用できません | | | twitter\_extended\_entities.media.video\_info.variants.bitrate | 利用できません | 利用できません | | | twitter\_extended\_entities.media.video\_info.variants.content\_type | 利用できません | 利用できません | | | twitter\_extended\_entities.media.video\_info.variants.url | 利用できません | 利用できません | | | 利用できません | includes.media.alt\_text | expansions=attachments.media\_keys\&media.fields=alt\_text | 文字列 | | 利用不可 | includes.media.public\_metrics | expansions=attachments.media\_keys\&media.fields=public\_metrics | オブジェクト | | 利用不可 | includes.media.public\_metrics.view\_count | expansions=attachments.media\_keys\&media.fields=public\_metrics | 整数 | | 利用不可 | includes.media.non\_public\_metrics | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | オブジェクト | | 利用不可 | includes.media.non\_public\_metrics.playback\_0\_count | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | 整数 | | 利用不可 | includes.media.non\_public\_metrics.playback\_25\_count | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | 整数 | | 利用不可 | includes.media.non\_public\_metrics.playback\_50\_count | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | 整数 | | 利用不可 | includes.media.non\_public\_metrics.playback\_75\_count | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | 整数 | | 利用不可 | includes.media.non\_public\_metrics.playback\_100\_count | expansions=attachments.media\_keys\&media.fields=non\_public\_metrics | 整数 | | 利用不可 | includes.media.organic\_metrics | expansions=attachments.media\_keys\&media.fields=organic\_metrics | オブジェクト | | なし | includes.media.organic\_metrics.playback\_0\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | Int | | なし | includes.media.organic\_metrics.playback\_25\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | Int | | なし | includes.media.organic\_metrics.playback\_50\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | Int | | なし | includes.media.organic\_metrics.playback\_75\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | Int | | なし | includes.media.organic\_metrics.playback\_100\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | Int | | なし | includes.media.organic\_metrics.view\_count | expansions=attachments.media\_keys\&media.fields=organic\_metrics | Int | | なし | includes.media.promoted\_metrics | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | Object | | なし | includes.media.promoted\_metrics.playback\_0\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | Int | | なし | includes.media.promoted\_metrics.playback\_25\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | Int | | なし | includes.media.promoted\_metrics.playback\_50\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | Int | | 利用できません | includes.media.promoted\_metrics.playback\_75\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | 整数 | | 利用できません | includes.media.promoted\_metrics.playback\_100\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | 整数 | | 利用できません | includes.media.promoted\_metrics.view\_count | expansions=attachments.media\_keys\&media.fields=promoted\_metrics | 整数 |
#### マッチングルールオブジェクト
| | | | | | :------------------------------- | :------------------ | :------------------ | :--------------- | | **Activity Streams 形式** | **Twitter v2 形式** | **必須の v2 パラメータ** | **v2 における type** | | gnip.matching\_rules | matching\_rules | フィルター済みストリームのデフォルト値 | オブジェクトの配列 | | gnip.matching\_rules.tag | matching\_rules.tag | フィルター済みストリームのデフォルト値 | 文字列 | | gnip.matching\_rules.tag.id | 利用不可 | 利用不可 | | | gnip.matching\_rules.tag.id\_str | matching\_rules.id | フィルター済みストリームのデフォルト値 | 文字列 |
### ビジュアルデータ形式移行ツール
ビジュアルデータ形式移行ツールは、指定したツイートまたはユーザーオブジェクトについて、[X API v1.1 のデータ形式](https://developer.x.com/en/docs/x-api/v1/data-dictionary/overview)のフィールドが [X API v2 形式](/ja/x-api/fundamentals/data-dictionary)のどのフィールドに対応するかを表示する Web アプリケーションです。ツールでこのマッピングを確認するには、ツイート ID またはユーザー ID のいずれかを入力します。 このアプリを利用するには、Twitter アカウントでログインする必要があります。