新しい Search Ads Reporting API の新しいコンセプト

Search Ads 360 Reporting API は最新のプラットフォームをベースとしており、いくつかの新しい概念が導入されています。これらについては、次のセクションで説明します。

リソース

レポートタイプはリソース オブジェクトに置き換えられました。事前定義のレポートタイプをリクエストする代わりに、SQL に似た新しいクエリ言語を使用してすべてのリソースをクエリできるようになりました。詳しくは、Search Ads 360 Reporting API の構造をご覧ください。

検索レポート作成

検索には、新しい API で独自のサービスが用意されています。検索サービスは、従来の Reports サービスに置き換わるものです。すべてのクエリは SearchAds360Service を経由します。SearchStreamSearch という 2 つのメソッドは、レポートデータと指標の検索と取得に使用されます。どちらの検索メソッドも、検索クエリに一致するすべての SearchAds360Row オブジェクトを返します。詳細については、検索レポートを作成するをご覧ください。

リソース メタデータ

SearchAds360FieldService を使用すると、SearchAds360Service 検索メソッドで使用可能なリソース、リソース フィールド、セグメンテーション キー、指標のカタログを動的にリクエストできます。詳細については、リソース メタデータの取得をご覧ください。

フィールド名

API では、ドット表記で区切られたネストされたフィールド名が導入されています。たとえば、campaign.idad_group.id です。さらにネストすることもできます(例: ad_group.campaign.id)。詳しくは、Search Ads 360 Reporting API の構造をご覧ください。

検索広告 360 従来版 API のレポートは、概念が類似しているさまざまなエンティティに対する個別のフィールドに基づいて作成されていました。たとえば、campaign レポートと adgroup レポートには、個別の campaignId フィールドが含まれています。

クエリ言語

この API では、検索広告 360 のクエリ言語が導入されています。これは SQL に似た柔軟な言語であり、ビジネスに最適な特定のレポートデータを取得するためのクエリを定義できます。詳しくは、検索広告 360 のクエリ言語をご覧ください。

get リクエスト

新しい API では、検索には独自のサービス(SearchAds360Service)がありますが、GET リクエストは各エンティティの特定のサービスに引き続き存在します。たとえば、CustomColumnService からカスタム列の情報を取得できます。詳しくは、Search Ads 360 Reporting API での形式の変更をご覧ください。

カスタム列

検索広告 360 リニューアル版では、数式列カスタム コンバージョンカスタム列と呼ばれます。カスタム列の詳細新しい CustomColumnService を使用すると、カスタム列を有効にできます。必要な権限があれば、アカウント ツリー内の任意のアカウントが所有する CustomColumn リソースをリクエストできます。

アカウント管理

検索広告 360 リニューアル版のアカウントは、マネージャー アカウント、サブマネージャー アカウント、クライアント アカウントの階層構造になっています。MCC アカウントは代理店アカウントを表し、サブマネージャー アカウントは検索広告 360 従来版の広告主アカウントを表します。詳しくは、検索広告 360 の MCC アカウントについてをご覧ください。

アカウント ツリーに対してクエリを実行し、レポートデータを取得するアカウントごとにリクエストを送信できます。

アカウント階層の変更に伴い、広告主/代理店のコンセプトに関連するフィールドは、可能な限り同等の機能を提供するために、適切な代替フィールドに置き換えられました。影響を受けるフィールドとその代替フィールドの一覧については、フィールド マッピングをご覧ください。

ログイン用のお客様 ID のヘッダー

login-customer-id は、MCC アカウントを使用してサブマネージャー アカウントまたはクライアント アカウントにアクセスする場合に必要な新しいヘッダーです。詳しくは、ログインお客様 ID ヘッダーをご覧ください。

バージョニング

Search Ads 360 Reporting API では、セマンティック バージョニングが使用されます。メジャー バージョンとマイナー バージョンがあり、vMAJOR_MINOR の形式になっています。詳細については、バージョニングをご覧ください。