Google広告透明性センター API
Google広告透明性センターには、Google検索、YouTube、Google Play、マップ、ショッピングで配信された、確認済み広告主の広告が掲載されています。adsは、ドメインまたは広告主IDで指定した1つの広告主の広告を最大100件返します。
advertiserには、lululemon.comのようなドメインか、ARで始まる広告主IDを渡します。広告はおおむね配信が新しい順に並びます。各行には広告テキスト、費用、インプレッション数は含まれません。クリエイティブを確認するにはurlまたはimage_urlを開いてください。advertiser_nameは確認済みの名称で、子会社や代理店の名前の場合があります。表示されるのは、Googleの確認手続きを完了した広告主のみです。
プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Google広告透明性センターの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
広告ads | advertiserに広告主のドメインまたは広告主IDを指定して、企業がGoogleで出稿した広告をGoogle広告透明性センターから最大100件取得します。各行には広告ID、形式（テキスト、画像、動画）、最初と最後の表示日時、プレビュー画像、広告透明性センター上の広告リンクが含まれます。country、format、surface、最初の表示日で絞り込めます。費用とインプレッション数は含まれません。 | 1,000リクエストあたり$0.68 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Google広告透明性センターの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
ads広告
| advertiser | country, end_date, format, start_date, surface | Sync配信 | カタログ値：defaultLimit=100、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$0.68 | rank · ad_id · advertiser_id · advertiser_name · domain · format · first_shown_at · last_shown_at · image_url · url · advertiser_ads_estimate · platform |
Google広告透明性センターのadsのパラメータはそれぞれどういう意味ですか？
advertiserに広告主のドメインまたは広告主IDを指定して、企業がGoogleで出稿した広告をGoogle広告透明性センターから最大100件取得します。各行には広告ID、形式（テキスト、画像、動画）、最初と最後の表示日時、プレビュー画像、広告透明性センター上の広告リンクが含まれます。country、format、surface、最初の表示日で絞り込めます。費用とインプレッション数は含まれません。
advertiser必須- 広告を一覧表示する広告主です。ドメイン（例：
nike.com）、またはARで始まる広告主ID（例：AR01614014350098432001）を指定します。広告透明性センターの広告主リンクも使用できます。マイアドセンターヘルプ：広告主の本人確認と広告透明性センター — Googleのヘルプページによると、広告主は法的な証明書類で本人確認を行う必要があり、広告透明性センターでは広告主名またはウェブサイトで検索し、配信地域と期間で絞り込むことができます。この資料は、ドメインまたは広告主による検索と、国や日付による絞り込みを裏付けるものです。このAPIのパラメータはEveryInfraが定義したもので、この資料は結果を保証するものではありません。 · 確認日 country任意- その国で表示された広告のみに絞り込むための2文字の国コードです（例：
us、gb）。省略するとすべての地域が対象になります。 end_date任意- この日付以前に初めて表示された広告のみに絞り込みます。形式はYYYY-MM-DDで、
start_dateより前の日付は指定できません。 format任意- 広告フォーマットを1つに絞り込みます。
text、image、videoのいずれかを指定します。指定可能な値:imagetextvideo start_date任意- この日付以降に初めて表示された広告のみに絞り込みます。形式はYYYY-MM-DDです。
surface任意- 1つのGoogleサービスで表示された広告のみに絞り込みます。
search、youtube、play、maps、shoppingのいずれかを指定します。
Google広告透明性センター APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"google_ads_transparency","action":"ads","params":{"advertiser":"<advertiser>"}}'
Google広告透明性センター APIに関する質問
Google広告透明性センター APIでは何を取得できますか？
platformをgoogle_ads_transparencyに設定します。現在のカタログには広告が掲載されています。これらのアクション名はそれぞれ異なるGoogle広告透明性センターのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Google広告透明性センターのadsリクエストを開始するには、どの入力を使用しますか？
広告を一覧表示する広告主です。ドメイン（例：nike.com）、またはARで始まる広告主ID（例：AR01614014350098432001）を指定します。広告透明性センターの広告主リンクも使用できます。params内のadvertiserとして送信してください。
Google広告透明性センターのadsはどのフィールドを返しますか？
宣言されたスキーマにはrank、ad_id、advertiser_id、advertiser_nameが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Google広告透明性センターのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。