動画をクロスポストする
動画を一度アップロードし、各プラットフォームに合わせたキャプションを書き、それぞれに適した形式を選択します。
手順
- 動画を取得する。 ユーザーがMP4ファイルの公開リンクを提供します。
urlを指定してupload_media_from_urlを呼び出します。動画はバックグラウンドでインポートされます。返されたmedia_idを使ってget_mediaを呼び出し、media_statusが"ready"になるまで確認します。"failed"になった場合は、error_messageを平易な言葉でユーザーに伝えてください。準備ができていない動画を添付しないでください。既にライブラリにある動画の場合は、list_mediaとtype: "video"で検索します。 - ルールを確認する。
get_platform_rulesを呼び出し、動画を各プラットフォームの長さ、サイズ、アスペクト比の制限と比較します。get_mediaで動画の詳細を確認します。動画がいずれかのプラットフォームのルールに違反する場合、そのプラットフォームは除外し、その理由をユーザーに伝えてください。 - アカウントを選択する。
list_accountsを呼び出します。ユーザーが指定したアカウント、またはビデオプラットフォーム上のすべての正常なアカウントを使用します。投稿できないアカウントはスキップし、その理由を説明してください。 - 各プラットフォームのキャプションを作成する。 一般的なキャプションを
contentに設定し、各プラットフォーム固有のものをplatform_contentに設定します。- TikTok:
{"tiktok": {"content": "..."}}。短く、フックを最初に、ハッシュタグは最後に。 - Instagram Reels:
{"instagram": {"content": "...", "contentType": "Reels"}}。ハッシュタグは最後に。 - YouTube Shorts:
{"youtube": {"content": "<description>", "contentType": "Short", "settings": {"title": "<title>"}}}。タイトルは100文字以内で、YouTubeでは<や>を使用できません。説明の最初の2行に動画の内容を記載します。通常のYouTube動画の場合は"contentType": "Video"を使用します。 - LinkedIn:
{"linkedin": {"content": "..."}}。クリックを誘う最初の行、短い段落。 - Facebook Reels:
{"facebook": {"content": "...", "contentType": "Reels"}}。 ブランドボイスガイドがある場合はそれに従ってください（brand-voiceを参照）。動画に関する事実をでっち上げないでください。内容がわからない場合はユーザーに尋ねてください。
- TikTok:
- 下書きを表示する。 プラットフォームごとに、形式、タイトル（YouTube）、キャプション、時間を表示します。ユーザーに確認を求めます。
- 作成する。
content、account_ids、media_ids: [<media_id>]、platform_content、およびdraft: trueを指定してcreate_postを呼び出します。ただし、ユーザーがすでに今すぐ公開するか、この特定の投稿の時間を指定している場合は除きます。 - 公開または予約する。 ユーザーが確認した後、
post_idとscheduled_for（timezoneを含む）またはpublish_now: trueを指定してschedule_postを呼び出します。 - 結果を確認する。 各プラットフォームで動画の処理に数分かかります。少し待ってから
get_post_resultsを呼び出し、公開されたプラットフォームとそのリンク、および失敗があれば平易な言葉で報告します（fix-failed-postsを参照）。
適切なデフォルト設定
- 縦型動画（9:16）はTikTok、Reels、Shortsに適しています。横型動画の場合は、ショートフォーム形式を選択する前に
get_platform_rulesを確認してください。 - 投稿ごとに1つの動画です。2つの動画を投稿する場合は、2つの投稿を作成します。