検索広告 360 のクエリ言語

検索広告 360 のクエリ言語を利用すると、Search Ads 360 Reporting API を使ってレポートデータとリソース メタデータを取得する検索クエリを作成できます。

サービスを検索

検索広告 360 のクエリ言語では、次を使って API にクエリを実行できます。

SearchAds360Service

このサービスを使用して、リソースとそれに関連する属性、セグメント、指標をクエリします。メソッドには、Search と SearchStream の 2 つがあります。

SearchAds360Service クエリは、SearchAds360Row インスタンスのリストを返します。

  • 各行は 1 つのリソースを表します。
  • リクエストされた場合、行には属性と指標フィールドが含まれます。
  • セグメントをリクエストすると、セグメントとリソースのタプルごとに追加の行が追加されます。

詳細については、検索レポートを作成するをご覧ください。

SearchAds360FieldService

このサービスを使用して、使用可能なフィールドとリソースに関するメタデータをクエリします。このサービスには、互換性とタイプの詳細を含むクエリ可能なフィールドのカタログが用意されています。

SearchAds360FieldService は SearchAds360Field インスタンスのリストを返します。

  • 各フィールドには、リクエストされたフィールドの詳細が含まれます。

詳細については、リソース メタデータの取得をご覧ください。

基本的なクエリの例

以降のセクションでは、独自のクエリの作成に使用できる基本的なクエリの例について説明します。

リソースの属性のクエリ

以下は、キャンペーン ID、名前、ステータスを返す campaign リソースの属性に対する基本的なクエリです。

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id
  • 返される各 SearchAds360Row は campaign オブジェクトを表します。
  • 行には選択したフィールド（指定したキャンペーンの resource_name を含む）が入力されます。
  • キャンペーン ID 別のクエリの並べ替え。

クエリで使用できる他のフィールドについては、campaign をご覧ください。

指標のクエリ

これは、campaign リソースの属性に関連する指標に対する基本的なクエリです。

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id
  • このクエリでは、ステータスが PAUSED で、インプレッション数が 1,000 を超えているキャンペーンが返されます。
  • 返される各 SearchAds360Row には、選択した指標が入力された metrics フィールドがあります。
  • キャンペーン ID 別のクエリの並べ替え。

クエリで使用できるその他の指標については、metrics をご覧ください。

セグメントのクエリ

以下は、campaign リソースの属性に関連するセグメントに対する基本的なクエリです。

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions,
  segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
  AND segments.date during LAST_30_DAYS
ORDER BY campaign.id
  • このクエリでは、ステータスが PAUSED で、インプレッション数が 1,000 を超えているキャンペーンが返されます。
  • データが日付別に分割される。
  • セグメンテーションの結果、各 SearchAds360Row はキャンペーンと日付セグメントのタプルを表します。
  • キャンペーン ID 別のクエリの並べ替え。

クエリで使用できるセグメントのリストについては segments を、レポートのセグメント化について詳しくはセグメンテーションをご覧ください。

campaign リソースに対する基本的なクエリで、bidding_strategy リソースの属性を結合します（利用可能な場合）。このタイプの関連リソースは、帰属するリソースと呼ばれます。

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id
  • このクエリは、選択した各キャンペーンからキャンペーン属性と関連属性を選択します。
  • 返される各 SearchAds360Row は、選択したキャンペーン属性と選択した入札戦略属性 bidding_strategy.name が入力された campaign オブジェクトを表します。

キャンペーン クエリで使用可能な帰属リソースを確認するには、campaign をご覧ください。

フィールド メタデータのクエリ

SearchAds360FieldService を使用してフィールド メタデータを取得できます。

フィールド メタデータに対する基本的なクエリは次のとおりです。

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD
  • RESOURCE OR FIELD は、リソース（customer、campaign など）またはフィールド（campaign.id、metrics.impressions、ad_group.id など）に置き換えます。

フィールド メタデータの取得の詳細については、リソース メタデータの取得をご覧ください。

詳細

Search Ads 360 Reporting API でクエリを作成する方法について詳しくは、以下をご覧ください。