format_id — 構造化参照オブジェクト
format_id は常に JSON オブジェクトであり、素の文字列ではありません。それは、フォーマットを宣言したエージェントとフォーマットのローカルスラッグによってフォーマットを識別します:
format_id はポインターです — 定義を運ばずにフォーマットを名指しします。
format — 完全な定義オブジェクト
format はクリエイティブフォーマットの完全な仕様です。それは list_creative_formats および関連タスクによって返されます。format オブジェクトはそのプロパティの 1 つとして format_id を含み、加えてアセット要件、レンダー仕様、その他すべてのメタデータを含みます:
format は定義です — フォーマットが何を必要とし、どうレンダリングするかを記述します。
一目での対比
名前付きの 2 つの失敗モード
アンチパターン A — format_id スロットの文字列
誤り — format_id は素の文字列ではなくオブジェクトでなければなりません:
format_id must be of type object。原因: format_id オブジェクト内の .id 文字列が自己完結した名前のように見え、時に抽出されて直接使われる。
アンチパターン B — format / formats スロットの format_id オブジェクト
誤り — formats[] の要素は素の format_id ではなく完全な定義オブジェクトでなければなりません:
formats[0] must have required property 'name'。原因: format_id と format はどちらもオブジェクト。より短いオブジェクトが、より大きいものを期待するスロットに時に置かれる。
関連項目
- クリエイティブフォーマット — 完全なフォーマットオブジェクト構造、アセットタイプ、レンダー仕様
- テンプレートフォーマット ID — dimension 可変テンプレート用のパラメーター化されたフォーマット ID