Node SDK
BulkPublish
Node SDK:SNS投稿の予約と公開に使う
依存関係のない、NodeとTypeScript向けの型付きクライアントです。すべての項目に補完が効く状態で、自分のコードから投稿、予約、分析の取得ができます。
Node SDK の操作一覧
Node SDKから使える操作は87個あり、下では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.list(),schedules.update() |
| テンプレート | templates.create(),templates.delete(),templates.get(),templates.list(),templates.update() |
投稿の届き先
Node SDKで予約した投稿は、ここにある15のネットワークのどれにでも届けられます。1アカウントだけでも、全アカウント同時でもかまいません。各ネットワークのページで上限や投稿形式を確認できます。
Node SDK の設定
パッケージをインストールし、APIキーでクライアントを作って、必要なメソッドを呼びます。型はパッケージに同梱されているので、各リクエストが何を受け付けるかエディタに表示されます。
- BulkPublishのアカウントを作り、投稿したいチャンネルをつなぎます。
- 設定を開き、次に開発者を開いて、APIキーを作ります。キーは1つの組織に属していて、ほかに影響を与えずに失効できます。
- リクエストごとにキーをbearerトークンとして送ります。リファレンスには操作ごとに動く例が載っています。
よくある使われ方
プロダクト、CMSのフック、夜間のジョブに予約投稿を加えたいJavaScriptやTypeScriptのチーム向けです。
- 1か月分の投稿をまとめてアップロードし、あとは決めた時刻にキューが送り出すのにまかせる。
- 一度書いて、どこにでも出す。同じ投稿をSNSごとに整えて、つないだチャンネルすべてに同時に出す。
- ブログやポッドキャストのRSSを見て、新しい記事が出た瞬間に自動で投稿する。
- 数字を取り戻す。インプレッション、エンゲージメント、リンククリックが、投稿を出したのと同じ経路で返ってくる。
詳細
Node SDKの実用的な情報をまとめました。設定するときにも、あとで確認するときにも使えます。
| 項目 | 内容 |
|---|---|
| 認証 | APIキー。設定、次に開発者から作成します |
| インストール | npm install bulkpublish |
| 操作数 | 87個の操作 |
| 対応SNS | 15のSNS |
よくある質問
Node SDKを接続する前によく寄せられる質問です。
BulkPublishのどこまで届きますか。
上の表にある87個の操作です。投稿、メディア、ラベル、チャンネルセット、繰り返し予約、RSS自動投稿、分析まで、アプリ自身が呼んでいるものはすべて含まれます。
認証はどうなっていますか。
APIキーをbearerトークンとして送ります。設定、次に開発者から作成してください。キーは1つの組織に属していて、ほかのキーに触れずに単独で失効できます。
どのSNSに投稿できますか。
1回の呼び出しで15すべてに投稿できます。同じ文面をそのまま送っても、SNSごとに上書きしてもかまいません。投稿は失敗してからではなく、キューに入る前に各SNSの制限に照らして検証されます。
画像や動画はアップロードできますか。
できます。小さいファイルは1リクエストで、大きい動画は直接アップロード用のURLを受け取ってストレージへ分割送信します。どちらの方法でもメディアIDが返り、それを投稿に添えます。
分析データは取得できますか。
できます。投稿ごとの指標とアカウント単位の集計は、それを公開しているすべてのSNSから返ってきます。リンククリックはBulkPublish自身が計測しているので、SNS側が何も返さない場合でも残ります。
利用は無料ですか。
無料プランを含め、どのプランでも無料です。API分の別料金はありません。ここから予約した投稿は、アプリで書いた投稿と同じ月間の投稿数に数えられます。
まだ解決しませんか?ヘルプセンターで手順を詳しく説明しています。
ガイドとチュートリアル
Node SDKを使ったブログのチュートリアル。
ほかの連携
BulkPublishはほかにも28のツールと連携できます。気になるものを選んで、接続方法を見てみてください。