メディアツール - UTAGE API ドキュメント

概要

メディア系ツールでは、動画・音声・通常メディア（画像・PDF等）の一覧取得・検索に加え、2段階アップロード（アップロードURL発行 → 完了通知）ができます。

動画フォルダ
  └── 動画
音声フォルダ
  └── 音声

動画・音声・メディアのアップロードは2段階方式です。media_video_upload_url 等でアップロードURLを発行し、ファイルをアップロードした後に media_video_complete 等で完了を通知します。

動画

media_video_list

アップロード済み動画の一覧を取得します。キーワード検索やフォルダでの絞り込みができます。 パラメータ:

パラメータ	型	必須	説明
`keyword`	string	-	動画名で部分一致検索
`folder_id`	string	-	フォルダIDで絞り込み
`page`	integer	-	ページ番号
`per_page`	integer	-	1ページあたりの件数

指示例:

「動画一覧を見せて」
「“セミナー”を含む動画を検索して」
「特定のフォルダ内の動画を一覧表示して」

media_video_folder_list

動画フォルダの一覧を取得します。パラメータはありません。 パラメータ: なし 指示例:

「動画フォルダの一覧を見せて」

音声

media_audio_list

アップロード済み音声ファイルの一覧を取得します。キーワード検索やフォルダでの絞り込みができます。 パラメータ:

パラメータ	型	必須	説明
`keyword`	string	-	音声名で部分一致検索
`folder_id`	string	-	フォルダIDで絞り込み
`page`	integer	-	ページ番号
`per_page`	integer	-	1ページあたりの件数

指示例:

「音声ファイル一覧を見せて」
「“ポッドキャスト”を含む音声を検索して」

media_audio_folder_list

音声フォルダの一覧を取得します。パラメータはありません。 パラメータ: なし 指示例:

「音声フォルダの一覧を見せて」

通常メディア

通常メディア（画像・PDF・Office・動画・音声等）の一覧取得・検索を行います。media_upload_url でアップロードしたファイルが対象です。

media_list

通常メディア（画像・PDF・Office・動画・音声等）の一覧を取得します。キーワード検索やフォルダでの絞り込みができます。動画/音声要素で再生する動画・音声は media_video_list / media_audio_list を使用してください。 パラメータ:

パラメータ	型	必須	説明
`keyword`	string	-	名前で部分一致検索
`folder_id`	string	-	フォルダIDで絞り込み
`page`	integer	-	ページ番号
`per_page`	integer	-	1ページあたりの件数

指示例:

「アップロード済みメディアの一覧を見せて」
「“ロゴ”を含むファイルを検索して」

media_folder_list

通常メディアフォルダの一覧を取得します。パラメータはありません。 パラメータ: なし 指示例:

「メディアフォルダの一覧を見せて」

アップロード

ファイルのアップロードは2段階で行います。*_upload_url でアップロードURL（presigned_post）を取得し、そのURLへファイル本体をPOSTした後、*_complete で確定します。

media_upload_url

通常メディア（画像・PDF・Office・動画・音声等）のアップロードURLを発行します。アップロードしたファイル自体の公開URLが発行されます。動画・音声をファネル・会員サイトの動画/音声要素で再生する場合は media_video_upload_url / media_audio_upload_url を使用してください。 パラメータ:

パラメータ	型	必須	説明
`filename`	string	必須	ファイル名（拡張子含む。例: logo.png）
`filetype`	string	必須	MIMEタイプ（例: image/png, video/mp4, audio/mpeg）
`folder_id`	string	-	フォルダID。未指定時はルート直下

指示例:

「画像をアップロードしたい」

media_complete

通常メディアのアップロード完了を通知します。presigned_post へファイル本体をアップロードした後に呼び出します。 パラメータ:

パラメータ	型	必須	説明
`media_id`	string	必須	`media_upload_url` レスポンスの `data.media_id`

指示例:

「アップロードが終わったので確定して」

media_video_upload_url

動画のアップロードURLを発行します。ファネル・会員サイトの動画要素で再生する動画をアップロードします。 パラメータ:

パラメータ	型	必須	説明
`filename`	string	必須	ファイル名（拡張子含む。例: seminar.mp4）
`filetype`	string	必須	MIMEタイプ（例: video/mp4）
`folder_id`	string	-	フォルダID。未指定時はルート直下

指示例:

「セミナー動画をアップロードしたい」

media_video_complete

動画のアップロード完了を通知します。確定すると最適化（エンコード）処理が自動で起動します。 パラメータ:

パラメータ	型	必須	説明
`media_id`	string	必須	`media_video_upload_url` レスポンスの `data.media_id`

指示例:

「動画のアップロードが終わったので確定して」

media_audio_upload_url

音声のアップロードURLを発行します。ファネル・会員サイトの音声要素で再生する音声をアップロードします。 パラメータ:

パラメータ	型	必須	説明
`filename`	string	必須	ファイル名（拡張子含む。例: podcast.mp3）
`filetype`	string	必須	MIMEタイプ（例: audio/mpeg）
`folder_id`	string	-	フォルダID。未指定時はルート直下

指示例:

「ポッドキャスト音声をアップロードしたい」

media_audio_complete

音声のアップロード完了を通知します。確定すると最適化（エンコード）処理が自動で起動します。 パラメータ:

パラメータ	型	必須	説明
`media_id`	string	必須	`media_audio_upload_url` レスポンスの `data.media_id`

指示例:

「音声のアップロードが終わったので確定して」

​概要

​動画

​media_video_list

​media_video_folder_list

​音声

​media_audio_list

​media_audio_folder_list

​通常メディア

​media_list

​media_folder_list

​アップロード

​media_upload_url

​media_complete

​media_video_upload_url

​media_video_complete

​media_audio_upload_url

​media_audio_complete

概要

動画

media_video_list

media_video_folder_list

音声

media_audio_list

media_audio_folder_list

通常メディア

media_list

media_folder_list

アップロード

media_upload_url

media_complete

media_video_upload_url

media_video_complete

media_audio_upload_url

media_audio_complete