Tweepy项目中的Extended Tweets功能详解

Tweepy项目中的Extended Tweets功能详解

tweepy tweepy/tweepy: Tweepy 是一个 Python 库，用于访问 Twitter API，使得在 Python 应用程序中集成 Twitter 功能变得容易。 项目地址: https://gitcode.com/gh_mirrors/tw/tweepy

引言

Twitter平台在2016年5月24日宣布了对推文处理方式的重大变革，特别是在回复和URL处理机制上。这些变化直接影响到了Twitter API的使用方式，而Tweepy作为Python中最流行的Twitter API封装库，也随之进行了相应的功能更新。

背景知识

Twitter历史上最著名的限制就是140字符的限制，但随着平台发展，Twitter逐步放宽了这一限制：

1. 2016年5月：改变了回复和URL的字符计数方式
2. 2017年9月：开始测试280字符限制（针对特定语言）
3. 2017年11月：正式将字符限制扩展到280字符（针对需要压缩表达的语言）

这些变化促使Twitter API需要进行相应的调整，而Tweepy也同步更新以支持这些新特性。

Tweepy中的Extended Tweets功能

在Tweepy中，任何返回Status对象的API方法都新增了一个tweet_mode参数，这个参数决定了如何处理推文文本。

兼容模式（默认）

当不指定tweet_mode或设置为compat时，Tweepy会使用兼容模式：

• text属性会被截断到140字符（如果需要）
• 如果发生截断，truncated属性会设为True
• entities只包含完全在140字符范围内的实体
• 截断的文本会以省略号、空格和缩短的自引用URL结尾

扩展模式

当tweet_mode设置为extended时：

• 不再有text属性，取而代之的是full_text属性
• full_text包含推文的完整未截断文本
• truncated属性始终为False
• entities包含所有实体
• 新增display_text_range属性，表示可显示内容的起止位置

处理转发的特殊考虑

在扩展模式下处理转发（Retweet）时需要特别注意：

• 转发推文的full_text可能仍会被省略号截断
• 可以通过访问retweeted_status属性的full_text来获取完整的转发内容

实际应用示例

以下代码展示了如何获取推文的完整文本，无论是普通推文还是转发：

status = api.get_status(id, tweet_mode="extended")
try:
    print(status.retweeted_status.full_text)
except AttributeError:  # 不是转发
    print(status.full_text)

这个例子中，我们首先尝试访问转发的原始推文内容，如果失败（抛出AttributeError），则说明这不是转发，直接打印当前推文内容即可。

最佳实践建议

1. 对于新项目，建议始终使用tweet_mode="extended"以获取完整推文内容
2. 处理转发时，记得检查retweeted_status属性
3. 注意display_text_range可以帮助你确定推文中实际用户生成内容的位置
4. 考虑兼容性问题，特别是如果需要与旧系统交互

通过合理使用Tweepy的Extended Tweets功能，开发者可以充分利用Twitter平台的最新特性，为用户提供更好的体验。

tweepy tweepy/tweepy: Tweepy 是一个 Python 库，用于访问 Twitter API，使得在 Python 应用程序中集成 Twitter 功能变得容易。 项目地址: https://gitcode.com/gh_mirrors/tw/tweepy