Skip to main content
クリエイティブライブラリ内のクリエイティブをブラウズ・フィルタリングします。フォーマット、ステータス、コンセプト、タグ、日付範囲、ダイナミック変数によるフィルタリング、ページネーション、オプションのフィールドエンリッチメントをサポートします。 クリエイティブライブラリをホストするすべてのエージェント — クリエイティブエージェント（広告サーバー、クリエイティブ管理プラットフォーム）およびクリエイティブを管理するセールスエージェント — が実装します。 レスポンスタイム: ~1秒（シンプルなデータベースルックアップ）

​
概要

主な機能:
  • フォーマット、ステータス、タグ、日付、アサインメント、コンセプト、変数でフィルタリング
  • 作成日、更新日、名前、ステータス、アサインメント数でソート
  • 大きなライブラリのためのカーソルベースのページネーション
  • アサインメント、配信スナップショット、アイテム、ダイナミッククリエイティブ最適化（DCO）変数をオプションで含めます
  • レスポンスサイズを削減するために特定のフィールドのみを返す
  • クリエイティブコンセプトでフィルタリング（サイズ/フォーマットをまたぐ関連クリエイティブのグループ）
  • DCO クリエイティブを見つけてダイナミックコンテンツスロットを確認します

​
リクエストパラメータ

スキーマ: creative/list-creatives-request.json

​
コアパラメータ

パラメータタイプ必須説明
filtersobjectNoフィルター条件 — 以下のフィルタリングオプションを参照
sortobjectNoソートパラメータ
paginationobjectNoページネーション制御

​
データ含有オプション

パラメータタイプ必須説明
include_assignmentsbooleanNoパッケージアサインメント情報を含める（デフォルト: true）
include_snapshotbooleanNo軽量な配信スナップショットを含める — ライフタイムインプレッションと最終配信日時（デフォルト: false）。詳細なアナリティクスには get_creative_delivery を使用します。
include_itemsbooleanNoカルーセルやネイティブ広告などのマルチアセットフォーマットのアイテムを含める（デフォルト: false）
include_variablesbooleanNoダイナミックコンテンツ変数定義を含める（デフォルト: false）
fieldsarrayNo返す特定のフィールド（すべてのフィールドを返すには省略）

​
フィルタリングオプション

filters オブジェクトは以下のオプションの組み合わせ可能なフィルターをサポートする:
フィルタータイプ説明
accountsarray所有アカウントでフィルタリング
format_typesstring[]高レベルのフォーマットタイプでフィルタリング（例: "video"、"display"）
format_idsformat_id[]構造化フォーマット ID でフィルタリング
statusesstring[]承認ステータスでフィルタリング
tagsstring[]タグでフィルタリング（すべてが一致する必要があります）
tags_anystring[]タグでフィルタリング（いずれかが一致すればよい）
name_containsstring大文字小文字を区別しない名前検索
creative_idsstring[]特定のクリエイティブ ID でフィルタリング（最大100）
concept_idsstring[]コンセプトグループでフィルタリング
has_variablesbooleanダイナミック変数を持つ DCO クリエイティブでフィルタリング
created_after / created_beforedate-time作成日範囲でフィルタリング
updated_after / updated_beforedate-time最終更新日範囲でフィルタリング
assigned_to_packagesstring[]パッケージアサインメントでフィルタリング *
media_buy_idsstring[]メディアバイアサインメントでフィルタリング *
unassignedboolean未アサインのクリエイティブでフィルタリング *
has_servedboolean少なくとも1つのインプレッションが配信されたクリエイティブでフィルタリング *
* アサインメント関連フィルターはセールスエージェント固有。スタンドアロンクリエイティブエージェントはこれらを無視します。
アーカイブ済みクリエイティブはデフォルトで除外されます。 結果にアーカイブ済みクリエイティブを含めるには、statuses 配列に明示的に "archived" を含めます。

​
ソートオプション

昇順または降順でさまざまなフィールドでソートする: 
{
  "sort": {
    "field": "created_date",
    "direction": "desc"
  }
}
利用可能なソートフィールド:
  • created_date - クリエイティブが作成された日時（デフォルト）
  • updated_date - クリエイティブが最後に変更された日時
  • name - クリエイティブ名（アルファベット順）
  • status - 承認ステータス
  • assignment_count - パッケージアサインメント数

​
ページネーション

カーソルベースのページネーションで結果セットのサイズを制御する: 
{
  "pagination": {
    "max_results": 50,
    "cursor": "eyJjcmVhdGVkX2RhdGUiOi4uLn0"
  }
}

​
レスポンスフォーマット

スキーマ: creative/list-creatives-response.json レスポンスはオプションのエンリッチメントを持つクリエイティブデータを提供します: 
{
  "query_summary": {
    "total_matching": 1,
    "returned": 1,
    "filters_applied": ["status=approved"]
  },
  "pagination": {
    "has_more": false,
    "total_count": 1
  },
  "creatives": [
    {
      "creative_id": "ft_88201",
      "name": "Holiday Sale - Medium Rectangle",
      "format_id": {
        "agent_url": "https://creative.example.com",
        "id": "display_static",
        "width": 300,
        "height": 250
      },
      "status": "approved",
      "created_date": "2026-01-15T10:30:00Z",
      "updated_date": "2026-01-15T14:20:00Z",
      "concept_id": "concept_holiday_2026",
      "concept_name": "Holiday 2026 Campaign",
      "variables": [
        {
          "variable_id": "headline_text",
          "name": "Headline",
          "variable_type": "text",
          "default_value": "Holiday Sale - 50% Off",
          "required": true
        }
      ]
    }
  ],
  "format_summary": {
    "display_static_300x250": 1
  },
  "status_summary": {
    "approved": 1
  }
}

​
クリエイティブごとのフィールド

フィールドタイプ説明
creative_idstring一意のクリエイティブ識別子
namestring人間が読める名前
format_idobject構造化フォーマット参照
statusstring承認ステータス
created_datestring作成タイムスタンプ
updated_datestring最終変更タイムスタンプ
assetsobjectクリエイティブアセット（画像、テキスト、URL など）
tagsstring[]分類用タグ
concept_idstringクリエイティブコンセプト ID
concept_namestring人間が読めるコンセプト名
variablesarrayDCO 変数定義（include_variables=true の場合）
assignmentsobjectパッケージアサインメント（include_assignments=true の場合）
snapshotobject配信スナップショット（include_snapshot=true の場合）
snapshot_unavailable_reasonstringスナップショットが欠けている理由 — SNAPSHOT_UNSUPPORTED、SNAPSHOT_TEMPORARILY_UNAVAILABLE、または SNAPSHOT_PERMISSION_DENIED
itemsarrayマルチアセットフォーマットのアイテム（include_items=true の場合）

​
配信スナップショット

include_snapshot=true の場合、各クリエイティブには「このクリエイティブはアクティブか?」「最後にいつ配信されたか?」などの運用上の質問のための軽量な配信スナップショットが含まれます。これはアナリティクスではない — 詳細なパフォーマンスデータには get_creative_delivery を使用します。 
{
  "snapshot": {
    "as_of": "2026-03-08T14:30:00Z",
    "staleness_seconds": 3600,
    "impressions": 145200,
    "last_served": "2026-03-07T22:15:00Z"
  }
}
フィールドタイプ必須説明
as_ofdate-timeYesこのスナップショットがキャプチャされた日時
staleness_secondsintegerYesデータの最大経過時間（秒）
impressionsintegerYesライフタイムインプレッション（任意の日付範囲にスコープされていない）
last_serveddate-timeNoこのクリエイティブが最後に配信された日時。一度も配信されていない場合は存在しません。

​
アカウント要件

ライブラリをホストするクリエイティブエージェントはバイヤーがクリエイティブをクエリする前にアクセスを確立できるよう accounts プロトコル（sync_accounts / list_accounts）を実装すべきです。これはセールスエージェントがメディアバイのために使用するのと同じ accounts プロトコルだ — 別バージョンはない。メディアバイのために accounts プロトコルを既に実装しているセールスエージェントは追加対応不要です。

​
使用例

​
変数を含むコンセプトスコープのクエリ

特定のコンセプト内のすべての承認済みクリエイティブを DCO 変数定義と共にリスト: 
{
  "filters": {
    "concept_ids": ["concept_holiday_2026"],
    "statuses": ["approved"]
  },
  "include_variables": true,
  "sort": {
    "field": "created_date",
    "direction": "desc"
  }
}

​
フォーマット固有のクエリ

コンセプトをまたいで特定のフォーマット ID に一致するクリエイティブを検索: 
{
  "filters": {
    "format_ids": [
      {
        "agent_url": "https://creative.example.com",
        "id": "display_static",
        "width": 300,
        "height": 250
      },
      {
        "agent_url": "https://creative.example.com",
        "id": "display_static",
        "width": 728,
        "height": 90
      }
    ],
    "statuses": ["approved"]
  }
}

​
DCO クリエイティブの検索

パーソナライズキャンペーン用のダイナミックコンテンツ変数を持つクリエイティブを検索: 
{
  "filters": {
    "has_variables": true,
    "statuses": ["approved"]
  },
  "include_variables": true
}

​
フィールド制限クエリ

選択ドロップダウン用の最小限のクリエイティブデータを取得: 
{
  "fields": ["creative_id", "name", "format_id", "status"],
  "include_assignments": false,
  "filters": {
    "statuses": ["approved"]
  },
  "sort": {
    "field": "name",
    "direction": "asc"
  }
}

​
ライブラリヘルスチェック

休眠しているアセットを特定するために配信スナップショットと共にアクティブなクリエイティブを検索: 
{
  "filters": {
    "media_buy_ids": ["mb_summer_2026", "mb_spring_2026"],
    "statuses": ["approved"]
  },
  "include_assignments": true,
  "include_snapshot": true,
  "sort": {
    "field": "updated_date",
    "direction": "desc"
  }
}

​
関連タスク

  • get_creative_delivery - 日付範囲、バリアント内訳、完全な配信メトリクスを含む詳細なパフォーマンスアナリティクス
  • build_creative - ライブラリクリエイティブからマニフェストをビルドするか、ゼロから生成します
  • sync_creatives - クリエイティブライブラリをホストするすべてのエージェントでクリエイティブアセットをアップロードして管理します
  • list_creative_formats - サポートされているクリエイティブフォーマットを発見します
  • preview_creative - クリエイティブマニフェストのプレビューを生成します