Skip to main content

概要

メディア系ツールでは、動画・音声・通常メディア(画像・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 からやり直してください。 パラメータ: 指示例:
  • 「音声のアップロードが終わったので確定して」