Skip to main content
AdCP はクリエイティブフォーマットを扱うとき、関連するが明確に異なる 2 つの概念を使います。名前が似ているため、再発する実装エラーを引き起こします — このページは両方を正確に定義し、2 つの失敗モードを名指しします。

format_id — 構造化参照オブジェクト

format_id常に JSON オブジェクトであり、素の文字列ではありません。それは、フォーマットを宣言したエージェントとフォーマットのローカルスラッグによってフォーマットを識別します:
任意の dimension と duration フィールドが、パラメーター化されたテンプレートフォーマットのためにそれを拡張します:
format_idポインターです — 定義を運ばずにフォーマットを名指しします。

format — 完全な定義オブジェクト

format はクリエイティブフォーマットの完全な仕様です。それは list_creative_formats および関連タスクによって返されます。format オブジェクトはそのプロパティの 1 つとして format_id を含み、加えてアセット要件、レンダー仕様、その他すべてのメタデータを含みます:
format定義です — フォーマットが何を必要とし、どうレンダリングするかを記述します。

一目での対比

名前付きの 2 つの失敗モード

アンチパターン A — format_id スロットの文字列

誤り — format_id は素の文字列ではなくオブジェクトでなければなりません:
正しい:
AJV エラー: format_id must be of type object。原因: format_id オブジェクト内の .id 文字列が自己完結した名前のように見え、時に抽出されて直接使われる。

アンチパターン B — format / formats スロットの format_id オブジェクト

誤り — formats[] の要素は素の format_id ではなく完全な定義オブジェクトでなければなりません:
正しい:
AJV エラー: formats[0] must have required property 'name'。原因: format_idformat はどちらもオブジェクト。より短いオブジェクトが、より大きいものを期待するスロットに時に置かれる。

関連項目