Python - Tweepy 中的 API.add_list_members()

介绍

Tweepy 是一个用于与 Twitter API 进行交互的 Python 库。它提供了一组简单易用的方法，用于检索与推文、用户、列表等相关的信息，并执行各种操作。

API.add_list_members() 是 Tweepy 库中的一个方法，它允许我们将一个或多个用户添加到给定的 Twitter 列表中。

语法

以下是 API.add_list_members() 的基本语法：

API.add_list_members(list_id, screen_names=None, user_ids=None)

参数

• list_id：要添加用户的列表的 ID 或全局代号。
• screen_names：要添加到列表中的一个或多个用户名，可以是一个字符串或一个包含多个用户名的列表。
• user_ids：要添加到列表中的一个或多个用户 ID，可以是一个整数或一个包含多个用户 ID 的列表。

至少需要提供 screen_names 或 user_ids 参数中的一个。

返回值

该方法没有直接返回值。如果操作成功，将返回 HTTP 200 响应。

示例

以下是使用 API.add_list_members() 方法的示例代码：

import tweepy

# 认证和授权
auth = tweepy.OAuthHandler("consumer_key", "consumer_secret")
auth.set_access_token("access_token", "access_token_secret")

# 创建一个 API 对象
api = tweepy.API(auth)

# 添加单个用户到列表
api.add_list_members("1234567890", screen_names="twitter_user")

# 添加多个用户到列表
api.add_list_members("1234567890", screen_names=["user1", "user2"])

# 添加用户 ID 到列表
api.add_list_members("1234567890", user_ids=[123456, 789012])

请确保替换示例代码中的 consumer_key、consumer_secret、access_token、access_token_secret 和 list_id 等值为有效的值。

注意事项

• 在使用 API.add_list_members() 方法之前，确保已经先创建了目标列表。
• list_id 可以是给定列表的数字 ID，也可以是全局代号（例如：@username/list-slug）。
• 在一个 API 调用中最多可以添加 100 个用户到列表中。
• 如果要添加的用户已经在列表中，他们将被静默地忽略。
• 当添加用户到公共列表时，该列表的拥有者可能会收到通知。

有关更多详细信息和示例，请参阅 Tweepy 官方文档。

注意: 上述 Markdown 格式仅仅是为了说明目的。请根据您的需要使用适当的方式进行文档编写。