Fields の仕組み
デフォルトでは、post lookup はid、text、edit_history_tweet_ids のみを返します。より多くのデータを取得するには、リクエストに fields パラメータを追加します。
利用可能な fields パラメータ
各オブジェクトタイプには専用の fields パラメータがあります。例: Post fields
tweet.fields を使用して特定の post フィールドをリクエストします。
Example response
例: User fields
user.fields を使用して特定のユーザーフィールドをリクエストします。
Example response
関連オブジェクトの fields
関連オブジェクトのフィールド(post の作者など)を取得するには、次の 2 つが必要です。- 関連オブジェクトを含めるための expansion
- そのオブジェクトタイプの fields パラメータ
Example response
一般的な fields の組み合わせ
- Post 分析
- User プロフィール
- 完全な post コンテキスト
- メディアの詳細
重要な注意事項
- レスポンスのフィールド順序はリクエスト順序と異なる場合があります
- レスポンスに欠落しているフィールドは、値が
nullか空であることを意味します - 一部のフィールドは特定の認証が必要です(例: private metrics は user context が必要)
- 利用可能なフィールドについては、各エンドポイントの API リファレンスを確認してください
次のステップ
Expansions
レスポンスに関連オブジェクトを含める。
Data Dictionary
すべてのオブジェクトの完全なフィールドリファレンス。