検索広告 360 クエリ言語を使用すると、検索広告 360 Reporting API を使用してレポートデータとリソース メタデータを取得する検索クエリを作成できます。
検索サービス
Search Ads 360 クエリ言語を使用して、次の方法で API をクエリできます。
SearchAds360Serviceこのサービスを使用して、リソースとそれに関連する属性、セグメント、指標をクエリします。
SearchとSearchStreamの 2 つのメソッドがあります。SearchAds360Serviceクエリは、SearchAds360Rowインスタンスのリストを返します。- 各行はリソースを表します。
- リクエストされた場合、行には属性フィールドと指標フィールドが含まれます。
- セグメントをリクエストすると、セグメントとリソースのタプルごとに、追加の行が追加されます。
詳細については、検索レポートを作成するをご覧ください。
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 でクエリを作成する方法について詳しくは、以下をご覧ください。