Twitter V2 Get Tweets API 查询失效？用 Expansions 解决公有度量数据问题

2024-03-13 07:31:15

解决 Twitter V2 Get Tweets API 查询参数失效问题：使用 Expansions 扩展公有度量数据

引言

Twitter V2 Get Tweets API 旨在获取单个推文的详细信息。然而，有时你可能会发现，通过这个 API 无法获取全面的推文详细信息，例如转发数、点赞数和地理标签。本文将探讨导致此问题的潜在原因，并提供分步指南来解决它。

问题分析

在典型的代码示例中，查询参数通常配置如下：

"tweet.fields": "attachments,author_id,context_annotations,conversation_id,created_at,entities,geo,id,in_reply_to_user_id,lang,public_metrics,referenced_tweets,reply_settings,source,text,withheld",

尽管指定了 "public_metrics" 字段，但响应中仍然缺少全面的推文度量数据。

解决方案

要解决这个问题，我们必须使用 expansions 参数来显式扩展公有度量数据。公有度量数据并不是推文对象的一部分，因此必须通过扩展来检索它们。

修改后的查询参数如下：

"tweet.fields": "attachments,author_id,context_annotations,conversation_id,created_at,entities,geo,id,in_reply_to_user_id,lang,referenced_tweets,reply_settings,source,text,withheld",
"expansions": "public_metrics",

修改后的代码示例

// 设置请求参数，包括所需的字段
const params = {
  "tweet.fields": "attachments,author_id,context_annotations,conversation_id,created_at,entities,geo,id,in_reply_to_user_id,lang,referenced_tweets,reply_settings,source,text,withheld",
  "expansions": "public_metrics",
  "user.fields": "created_at,description,entities,id,location,name,pinned_tweet_id,profile_image_url,protected,public_metrics,url,username,verified,verified_type,withheld",
  "media.fields": "duration_ms,height,media_key,preview_image_url,type,url,width,public_metrics,alt_text,variants",
  "place.fields": "contained_within,country,country_code,full_name,geo,id,name,place_type",
  "poll.fields": "duration_minutes,end_datetime,id,options,voting_status",
};

结论

通过显式使用 expansions 参数扩展公有度量数据，Twitter V2 Get Tweets API 现在将返回包含全面推文详细信息的响应。通过遵循这些步骤，你可以解决查询参数无法获取全面的推文详细信息的问题。

常见问题解答

为什么 public_metrics 数据不是推文对象的一部分？
答：公有度量数据涉及实时统计信息，在推文创建时并不可用。因此，它们必须通过扩展来单独检索。
我可以扩展哪些其他字段？
答：除了 public_metrics 之外，还可以扩展其他字段，例如作者信息、媒体附件和地理标签。有关完整列表，请参考 Twitter 开发人员文档。
expansions 参数会影响 API 速率限制吗？
答：是的，扩展数据会增加 API 调用中返回的数据量，从而可能影响速率限制。
为什么我的代码在修改后仍然无法正常工作？
答：请确保正确设置了你的 Twitter API 密钥和令牌，并且正在使用最新的 Twitter API 版本。
我可以通过其他方式获取全面的推文详细信息吗？
答：是的，你还可以使用 Tweet Search API 来搜索推文，该 API 也可以返回公有度量数据。