概要
メディア系ツールでは、動画・音声・通常メディア(画像・PDF等)の一覧取得・検索に加え、2段階アップロード(アップロードURL発行 → 完了通知)と名称変更ができます。動画・音声・メディアのアップロードは2段階方式です。
media_video_upload_url 等でアップロードURLを発行し、ファイルをアップロードした後に media_video_complete 等で完了を通知します。動画
media_video_list
アップロード済み動画の一覧を取得します。キーワード検索やフォルダでの絞り込みができます。 パラメータ:
指示例:
- 「動画一覧を見せて」
- 「“セミナー”を含む動画を検索して」
- 「特定のフォルダ内の動画を一覧表示して」
media_video_folder_list
動画フォルダの一覧を取得します。パラメータはありません。 パラメータ: なし 指示例:- 「動画フォルダの一覧を見せて」
media_video_update
動画の名称を変更します。media_video_list で取得した動画が対象です。
パラメータ:
指示例:
- 「この動画の名称を”セミナー第1回”に変更して」
音声
media_audio_list
アップロード済み音声ファイルの一覧を取得します。キーワード検索やフォルダでの絞り込みができます。 パラメータ:
指示例:
- 「音声ファイル一覧を見せて」
- 「“ポッドキャスト”を含む音声を検索して」
media_audio_folder_list
音声フォルダの一覧を取得します。パラメータはありません。 パラメータ: なし 指示例:- 「音声フォルダの一覧を見せて」
media_audio_update
音声の名称を変更します。media_audio_list で取得した音声が対象です。
パラメータ:
指示例:
- 「この音声の名称を”ポッドキャスト第1回”に変更して」
通常メディア
通常メディア(画像・PDF・Office・動画・音声等)の一覧取得・検索を行います。管理画面「メディア管理」にあるファイル(画面・API どちらからアップロードしたものも)が対象です。media_list
通常メディア(画像・PDF・Office・動画・音声等)の一覧を取得します。キーワード検索やフォルダでの絞り込みができます。動画/音声要素で再生する動画・音声はmedia_video_list / media_audio_list を使用してください。
パラメータ:
指示例:
- 「アップロード済みメディアの一覧を見せて」
- 「“ロゴ”を含むファイルを検索して」
media_folder_list
通常メディアフォルダの一覧を取得します。パラメータはありません。 パラメータ: なし 指示例:- 「メディアフォルダの一覧を見せて」
media_update
通常メディアの名称を変更します。media_list で取得した通常メディアが対象です。
パラメータ:
指示例:
- 「このファイルの名称を”会社ロゴ.png”に変更して」
アップロード
ファイルのアップロードは2段階で行います。*_upload_url でアップロードURL(presigned_post)を取得し、そのURLへファイル本体をPOSTした後、*_complete で確定します。
media_upload_url
通常メディア(画像・PDF・Office・動画・音声等)のアップロードURLを発行します。アップロードしたファイル自体の公開URLが発行されます。動画・音声をファネル・会員サイトの動画/音声要素で再生する場合はmedia_video_upload_url / media_audio_upload_url を使用してください。
パラメータ:
指示例:
- 「画像をアップロードしたい」
media_complete
通常メディアのアップロード完了を通知します。presigned_post へファイル本体をアップロードした後に呼び出します。ファイルの存在とファイル形式(Content-Type とファイル先頭のシグネチャ)を検証し、検証に失敗した場合(エラー invalid_filetype)はメディアとアップロード済みファイルが削除されて同じ media_id は使えなくなります。media_upload_url からやり直してください。
パラメータ:
指示例:
- 「アップロードが終わったので確定して」
media_video_upload_url
動画のアップロードURLを発行します。ファネル・会員サイトの動画要素で再生する動画をアップロードします。 パラメータ:
指示例:
- 「セミナー動画をアップロードしたい」
media_video_complete
動画のアップロード完了を通知します。確定すると最適化(エンコード)処理が自動で起動します。結果のstatus は通常 processing、エンコード処理を起動できなかった場合は error です。確定時にファイル形式(Content-Type とファイル先頭のシグネチャ)を検証し、失敗した場合(エラー invalid_filetype)はメディアとアップロード済みファイルが削除されて同じ media_id は使えなくなります。media_video_upload_url からやり直してください。
パラメータ:
指示例:
- 「動画のアップロードが終わったので確定して」
media_audio_upload_url
音声のアップロードURLを発行します。ファネル・会員サイトの音声要素で再生する音声をアップロードします。 パラメータ:
指示例:
- 「ポッドキャスト音声をアップロードしたい」
media_audio_complete
音声のアップロード完了を通知します。確定すると最適化(エンコード)処理が自動で起動します。結果のstatus は通常 processing、エンコード処理を起動できなかった場合は error です。確定時にファイル形式(Content-Type とファイル先頭のシグネチャ)を検証し、失敗した場合(エラー invalid_filetype)はメディアとアップロード済みファイルが削除されて同じ media_id は使えなくなります。media_audio_upload_url からやり直してください。
パラメータ:
指示例:
- 「音声のアップロードが終わったので確定して」