Node SDK
BulkPublish
用 Node SDK 定时发布社交媒体内容
一个零依赖、带类型的 Node 与 TypeScript 客户端。在自己的代码里发布、排期、读取数据分析,每个字段都有自动补全。
适合要在产品、CMS 钩子或夜间任务里加入定时发布的 JavaScript 和 TypeScript 团队。
Node SDK 设置
安装这个包,用 API 密钥创建客户端,调用需要的方法即可。类型定义随包附带,编辑器会显示每个请求接受哪些参数。
- 注册一个 BulkPublish 账号,并连接你要发布的渠道。
- 打开设置,再打开开发者,创建一个 API 密钥。每个密钥只属于一个组织,撤销它不会影响其他部分。
- 每次请求都用 bearer token 带上这个密钥。参考文档为每个操作都给了完整示例。
Node SDK 的操作
Node SDK 可以使用 88 个操作,下面按 17 个类别列出。这份清单直接读取自 Node SDK 所调用的代码,所以上面的每一项现在都能用。
| 范围 | 操作 |
|---|---|
| 数据分析 | analytics.account(),analytics.engagement(),analytics.links(),analytics.postHistory(),analytics.refresh(),analytics.summary() |
| 日历备注 | calendarNotes.create(),calendarNotes.delete(),calendarNotes.list(),calendarNotes.update() |
| 渠道组 | channelSets.create(),channelSets.delete(),channelSets.list(),channelSets.update() |
| 渠道 | channels.delete(),channels.get(),channels.health(),channels.list(),channels.update() |
| 客户端连接链接 | clientConnectLinks.create(),clientConnectLinks.delete(),clientConnectLinks.list() |
| 话题标签组 | hashtagGroups.create(),hashtagGroups.delete(),hashtagGroups.get(),hashtagGroups.list(),hashtagGroups.update() |
| 收件箱 | inbox.listConversations(),inbox.listMessages(),inbox.sendMessage(),inbox.updateConversation() |
| 标签 | labels.create(),labels.delete(),labels.list(),labels.update() |
| 媒体 | media.abortMultipart(),media.completeMultipart(),media.createMultipart(),media.delete(),media.get(),media.getLabels(),media.list(),media.setLabels(),media.update(),media.upload() |
| 通知 | notifications.delete(),notifications.list(),notifications.markRead(),notifications.preferences(),notifications.updatePreferences() |
| 组织 | organizations.create(),organizations.list() |
| 平台 | platforms.list() |
| 内容 | posts.approve(),posts.bulk(),posts.create(),posts.delete(),posts.engagement(),posts.get(),posts.list(),posts.metrics(),posts.moderateComment(),posts.publish(),posts.queueSlot(),posts.reject(),posts.replyToComment(),posts.retry(),posts.share(),posts.story(),posts.unshare(),posts.update() |
| 审核链接 | reviewLinks.create(),reviewLinks.delete(),reviewLinks.list() |
| RSS 自动发布 | rssFeeds.create(),rssFeeds.delete(),rssFeeds.list(),rssFeeds.update() |
| 周期计划 | schedules.create(),schedules.delete(),schedules.get(),schedules.list(),schedules.update() |
| 模板 | templates.create(),templates.delete(),templates.get(),templates.list(),templates.update() |
内容会发到哪里
Node SDK 安排的内容可以发到下面这 15 个网络中的任意一个,可以只发一个账号,也可以所有账号一起发。点进每个网络,可以看到它的限制和内容类型。
细节
关于 Node SDK 的实用信息都在这里,现在设置或以后查阅都方便。
| 项目 | 内容 |
|---|---|
| 认证方式 | API 密钥,在设置里的开发者页面创建 |
| 安装 | npm install bulkpublish |
| 获取方式 | npm |
| 操作数 | 88 个操作 |
| 平台数 | 15 个平台 |
常见问题
连接 Node SDK 之前,大家通常想知道这些。
纯 JavaScript 和 TypeScript 都能用吗?
都能。这是一个同时适用于两者的包,没有任何依赖,类型定义也内置其中,所以 TypeScript 项目无需额外安装就能为每个字段提供自动补全。
能从 CMS 钩子或夜间任务中调用吗?
能。在代码运行的任何地方,比如 CMS 钩子或夜间任务中,用你的 API 密钥创建一个客户端,然后调用你需要的方法。
它能覆盖 BulkPublish 的哪些部分?
上面表里的 88 个操作。内容、媒体、标签、渠道组、周期计划、RSS 自动发布和数据分析都在内,也就是应用自己会调用的全部。
认证是怎么做的?
用 API 密钥,以 bearer token 发送。在设置里的开发者页面创建。每个密钥属于一个组织,可以单独撤销,不影响其他密钥。
可以上传图片和视频吗?
可以。小文件一次请求上传,大视频则取一个直传地址,分片直接送到存储。两种方式都会返回一个媒体 id,附到内容上即可。
还没解决?帮助中心提供了详细的分步说明。
指南与教程
我们博客中使用 Node SDK 的教程。
其他集成
BulkPublish 还能和另外 5 个工具配合使用。选一个看看它怎么连接。