クリエイティブ
Alphacreative_media_imports_create
creative フラグが有効な接続先ワークスペースに、TikTok または Instagram の公開動画を取り込みます。
操作 書き込み。読み取りと書き込みを許可した OAuth 接続が必要です。
パラメーター
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
body | オブジェクト | はい | メディア取込の入力。 |
body.url | 文字列 | はい | TikTok または Instagram の公開動画・リールの URL。 |
body.get_transcript | 真偽値 | いいえ | TikTok が提供する文字起こしを取得します。Instagram では無視します。 |
body.source_media_url | 文字列 | いいえ | 投稿元 CDN の動画 URL。取得できない場合は投稿 URL から取得します。 |
body.mode | 文字列 | いいえ | async(既定)、sync、subscribe、webhook のいずれか。 |
body.webhook_url | 文字列 | いいえ | 終了通知を受け取る公開 HTTPS URL。webhook モードでは必須。 |
body.wait_timeout_seconds | 整数 | いいえ | sync と subscribe の HTTP 待機時間。0〜30 秒で、既定は 30 秒。 |
body.project_id | 文字列 | いいえ | 接続先ワークスペースの保存先プロジェクト ID。 |
idempotency_key | 文字列 | はい | 同じ入力で再試行する場合は同じキーを使います。 |
approval_receipt | 文字列 | いいえ | プランの承認後に渡すレシート。 |
承認後、同じ入力と approval_receipt を送信します。data.job.id を creative_jobs_wait に渡します。終了後、data.media_import_id を creative_media_imports_get の path.id に指定します。取込に Creative クレジットはかかりません。
ログインせずに再生できる公開動画を指定します。取り込める MP4 は最大 50 MiB、300 秒です。ログインが必要な投稿の取込は失敗し、error.code に provider_submission_failed、error.public_reason に source_login_required が返ります。
依頼例
この Instagram の公開リールをワークスペースに取り込み、動画素材として使えるまで待ってください。