Search Ads 360 Reporting API は最新のプラットフォームをベースとしており、いくつかの新しい概念が導入されています。これらについては、次のセクションで説明します。
リソース
レポートタイプはリソース オブジェクトに置き換えられました。事前定義のレポートタイプをリクエストする代わりに、SQL に似た新しいクエリ言語を使用してすべてのリソースをクエリできるようになりました。詳しくは、Search Ads 360 Reporting API の構造をご覧ください。
検索レポート作成
検索には、新しい API で独自のサービスが用意されています。検索サービスは、従来の Reports サービスに置き換わるものです。すべてのクエリは SearchAds360Service
を経由します。SearchStream
と Search
という 2 つのメソッドは、レポートデータと指標の検索と取得に使用されます。どちらの検索メソッドも、検索クエリに一致するすべての SearchAds360Row
オブジェクトを返します。詳細については、検索レポートを作成するをご覧ください。
リソース メタデータ
SearchAds360FieldService
を使用すると、SearchAds360Service
検索メソッドで使用可能なリソース、リソース フィールド、セグメンテーション キー、指標のカタログを動的にリクエストできます。詳細については、リソース メタデータの取得をご覧ください。
フィールド名
API では、ドット表記で区切られたネストされたフィールド名が導入されています。たとえば、campaign.id
や ad_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
の形式になっています。詳細については、バージョニングをご覧ください。