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