クリエイティブ
Alpha

creative_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 の公開リールをワークスペースに取り込み、動画素材として使えるまで待ってください。