Python SDK
BulkPublish
用 Python SDK 定时发布社交媒体内容
用 Python 发布内容,客户端顺着你的习惯来:脚本用同步,服务用异步。排期内容、上传媒体,把数据分析拉进你自己的分析流程。
适合需要内置发布或报表功能的数据团队、自动化脚本,以及 Django 或 FastAPI 应用。
Python SDK 设置
用 pip 安装,传入 API 密钥,选用同步或异步客户端即可。两者提供相同的方法。
- 注册一个 BulkPublish 账号,并连接你要发布的渠道。
- 打开设置,再打开开发者,创建一个 API 密钥。每个密钥只属于一个组织,撤销它不会影响其他部分。
- 每次请求都用 bearer token 带上这个密钥。参考文档为每个操作都给了完整示例。
Python SDK 的操作
Python SDK 可以使用 90 个操作,下面按 17 个类别列出。这份清单直接读取自 Python SDK 所调用的代码,所以上面的每一项现在都能用。
| 范围 | 操作 |
|---|---|
| 数据分析 | analytics.account(),analytics.engagement(),analytics.links(),analytics.post_history(),analytics.refresh(),analytics.summary() |
| 日历备注 | calendar_notes.create(),calendar_notes.delete(),calendar_notes.list(),calendar_notes.update() |
| 渠道组 | channel_sets.create(),channel_sets.delete(),channel_sets.list(),channel_sets.update() |
| 渠道 | channels.disconnect(),channels.get(),channels.health(),channels.list(),channels.list_platforms(),channels.update() |
| 客户端连接链接 | client_connect_links.create(),client_connect_links.delete(),client_connect_links.list() |
| 话题标签组 | hashtag_groups.create(),hashtag_groups.delete(),hashtag_groups.get(),hashtag_groups.list(),hashtag_groups.update() |
| 收件箱 | inbox.list_conversations(),inbox.list_messages(),inbox.send_message(),inbox.update_conversation() |
| 标签 | labels.create(),labels.delete(),labels.list(),labels.update() |
| 媒体 | media.abort_multipart(),media.complete_multipart(),media.create_multipart(),media.delete(),media.get(),media.get_labels(),media.list(),media.set_labels(),media.thumbnail(),media.update(),media.upload() |
| 通知 | notifications.delete(),notifications.list(),notifications.mark_read(),notifications.preferences(),notifications.update_preferences() |
| 组织 | organizations.create(),organizations.list() |
| 平台 | platforms.list() |
| 内容 | posts.approve(),posts.bulk(),posts.create(),posts.delete(),posts.engagement(),posts.get(),posts.list(),posts.metrics(),posts.moderate_comment(),posts.publish(),posts.publish_as_story(),posts.queue_slot(),posts.reject(),posts.reply_to_comment(),posts.retry(),posts.share(),posts.unshare(),posts.update() |
| 审核链接 | review_links.create(),review_links.delete(),review_links.list() |
| RSS 自动发布 | rss_feeds.create(),rss_feeds.delete(),rss_feeds.list(),rss_feeds.update() |
| 周期计划 | schedules.create(),schedules.delete(),schedules.get(),schedules.list(),schedules.update() |
| 模板 | templates.create(),templates.delete(),templates.get(),templates.list(),templates.update() |
内容会发到哪里
Python SDK 安排的内容可以发到下面这 15 个网络中的任意一个,可以只发一个账号,也可以所有账号一起发。点进每个网络,可以看到它的限制和内容类型。
细节
关于 Python SDK 的实用信息都在这里,现在设置或以后查阅都方便。
| 项目 | 内容 |
|---|---|
| 认证方式 | API 密钥,在设置里的开发者页面创建 |
| 安装 | pip install bulkpublish |
| 获取方式 | PyPI |
| 操作数 | 90 个操作 |
| 平台数 | 15 个平台 |
常见问题
连接 Python SDK 之前,大家通常想知道这些。
有异步客户端吗?
有。有用于脚本的同步客户端,也有用于服务的异步客户端,两者提供相同的方法。
能把数据分析导入我自己的分析吗?
能。数据分析会以你自己的脚本可以处理的数据形式返回,所以报表可以和发帖、媒体上传放在同一份代码里。
它能覆盖 BulkPublish 的哪些部分?
上面表里的 90 个操作。内容、媒体、标签、渠道组、周期计划、RSS 自动发布和数据分析都在内,也就是应用自己会调用的全部。
认证是怎么做的?
用 API 密钥,以 bearer token 发送。在设置里的开发者页面创建。每个密钥属于一个组织,可以单独撤销,不影响其他密钥。
可以上传图片和视频吗?
可以。小文件一次请求上传,大视频则取一个直传地址,分片直接送到存储。两种方式都会返回一个媒体 id,附到内容上即可。
还没解决?帮助中心提供了详细的分步说明。
指南与教程
我们博客中使用 Python SDK 的教程。
其他集成
BulkPublish 还能和另外 5 个工具配合使用。选一个看看它怎么连接。