Search Ads 360 Reporting API は最新のプラットフォームを基盤としており、さまざまな新しいコンセプトが導入されています。以降のセクションで詳しく説明します。
リソース
リソース オブジェクトはレポートタイプに代わるものです。事前定義されたレポートタイプをリクエストする代わりに、新しい SQL に似たクエリ言語を使用してすべてのリソースをクエリできるようになりました。詳しくは、Search Ads 360 Reporting API の構造をご覧ください。
検索レポート作成
新しい API では、検索に独自のサービスが用意されています。検索サービスは、以前のレポート サービスに代わるものです。すべてのクエリは SearchAds360Service を通過します。この SearchAds360Service には、レポートデータと指標を検索して取得するための 2 つのメソッド(SearchStream と Search)があります。どちらの検索メソッドも、検索クエリに一致するすべての 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 は、マネージャー アカウントを使用してサブマネージャー アカウントまたはクライアント アカウントにアクセスする際に必要な新しいヘッダーです。詳細については、ログイン顧客 ID ヘッダーをご覧ください。
バージョニング
Search Ads 360 Reporting API はセマンティック バージョニングを使用します。メジャー バージョンとマイナー バージョンがあり、vMAJOR_MINOR の形式で指定します。詳しくは、バージョニングをご覧ください。