Python SDK
BulkPublish
Python SDK:定时发布社交媒体内容
用 Python 发布内容,客户端顺着你的习惯来:脚本用同步,服务用异步。排期内容、上传媒体,把数据分析拉进你自己的分析流程。
Python SDK 的操作
Python SDK 可以使用 89 个操作,下面按 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.list(),schedules.update() |
| 模板 | templates.create(),templates.delete(),templates.get(),templates.list(),templates.update() |
内容会发到哪里
Python SDK 安排的内容可以发到下面这 15 个网络中的任意一个,可以只发一个账号,也可以所有账号一起发。点进每个网络,可以看到它的限制和内容类型。
Python SDK 设置
用 pip 安装,传入 API 密钥,选用同步或异步客户端即可。两者提供相同的方法。
- 注册一个 BulkPublish 账号,并连接你要发布的渠道。
- 打开设置,再打开开发者,创建一个 API 密钥。每个密钥只属于一个组织,撤销它不会影响其他部分。
- 每次请求都用 bearer token 带上这个密钥。参考文档为每个操作都给了完整示例。
团队通常怎么用
适合需要内置发布或报表功能的数据团队、自动化脚本,以及 Django 或 FastAPI 应用。
- 一次上传一个月的内容,剩下的交给队列,按你定的时间发出去。
- 写一次,处处发布。同一条内容按平台调整后,同时发到所有已连接的渠道。
- 把博客或播客的 RSS 变成自动内容,新条目一出现就发。
- 把数据读回来。曝光、互动和链接点击,沿着内容发出去的同一条路回来。
细节
关于 Python SDK 的实用信息都在这里,现在设置或以后查阅都方便。
| 项目 | 内容 |
|---|---|
| 认证方式 | API 密钥,在设置里的开发者页面创建 |
| 安装 | pip install bulkpublish |
| 操作数 | 89 个操作 |
| 平台数 | 15 个平台 |
常见问题
连接 Python SDK 之前,大家通常想知道这些。
它能覆盖 BulkPublish 的哪些部分?
上面表里的 89 个操作。内容、媒体、标签、渠道组、周期计划、RSS 自动发布和数据分析都在内,也就是应用自己会调用的全部。
认证是怎么做的?
用 API 密钥,以 bearer token 发送。在设置里的开发者页面创建。每个密钥属于一个组织,可以单独撤销,不影响其他密钥。
我能发到哪些平台?
一次调用就能发到全部 15 个。可以各平台都用同一段文字,也可以逐个覆盖。每条内容在入队之前就会按各平台的限制校验,而不是等到失败之后。
可以上传图片和视频吗?
可以。小文件一次请求上传,大视频则取一个直传地址,分片直接送到存储。两种方式都会返回一个媒体 id,附到内容上即可。
可以把数据读回来吗?
可以。单条内容的指标和账号维度的汇总,凡是平台公开的都会返回;链接点击由 BulkPublish 自己统计,所以平台什么都不报的地方也有数据。
使用是免费的吗?
是的,所有方案都免费,包括免费方案。没有单独的 API 费用。这里安排的内容和在应用里写的内容,计入同一个月度额度。
还没解决?帮助中心提供了详细的分步说明。
指南与教程
我们博客中使用 Python SDK 的教程。
其他集成
BulkPublish 还能和另外 28 个工具配合使用。选一个看看它怎么连接。