タグ管理（v1 専用）

お知らせ

このドキュメントは機械翻訳で作成された下書きであり、現在レビュー中です。機械翻訳の特性上、一部の内容が不正確であったり、韓国語の原文と異なる場合があります。より正確な情報については、韓国語のドキュメントをご参照ください。

タグ管理機能の未サポートについて

サポート範囲: タグの生成/追加/削除/検索に関連するすべてのエンドポイントは、v1 でのみ提供されていたレガシー機能であり、v2 および v3 の仕様では完全に廃止されました。
移行時の推奨事項: v3 への移行時は、カテゴリを細分化して割り当てる方式など、代替のビジネスロジックへのシステム改編を推奨します。

タグ別コンテンツ一覧取得

v1 レスポンス構造の特記事項

v1 のレスポンス構造は、最新の API 標準とやや異なる特殊なケースを含んでいます。移行前にレガシーシステムのレスポンスパーサーロジックを分析する際に参考にしてください。

message フィールドの欠落: { "error", "result" } 構造のみ存在し、message フィールドはレスポンスに含まれません。
データ型の不一致（count）: 全体の結果件数を表す result.count 値が Integer ではなく文字列（例: "0"）型で返されます。
配列のネスト構造の不整合（items）:
- 検索結果データが1 件以上存在する場合、items.item 配下の配列オブジェクトとしてネストされて返されます。（{"items": {"item": [...]}}）
- 検索結果が0 件の場合、items キー自体が空の配列構造として返されます。（{"items": []}）
レスポンスフィールドの型: レスポンスデータのうち original_file_size、status、タイムスタンプデータは Integer 型で返され、audio_channel は Boolean 型で返されます。
フィールド名の注意点: ビデオフレーム数のフィールド名はアンダーバー（_）が省略された video_framecount の形式です。

リクエストボディおよびレスポンス構造の詳細

フィールド	データ型	必須項目	説明
`tag`	String	必須	追加するタグ文字列
`upload_file_key`	String	必須	タグ追加対象のコンテンツ識別子

{
  "error": 0,
  "message": "success",
  "result": {}
}

リクエストボディおよびレスポンス構造の詳細

リクエストボディの仕様は、タグ追加 API と完全に同一です。

フィールド	データ型	必須項目	説明
`tag`	String	必須	削除するタグ文字列
`upload_file_key`	String	必須	タグ削除対象のコンテンツ識別子

タグ追加 API と同様に、成功時は空の result オブジェクトを返します。

{
  "error": 0,
  "message": "success",
  "result": {}
}