このページは Cloud Translation API によって翻訳されました。

Google 広告クエリ言語

Google 広告クエリ言語を使って、Google Ads API に対して次の点をクエリできます。

リソースとそれに関連する属性、セグメント、指標

GoogleAdsService [検索] または [SearchStream]

GoogleAdsService クエリの結果は、 GoogleAdsRow インスタンス（各 GoogleAdsRow）指定します。属性または指標がリクエストされた場合、行にはこれらのフィールドも含まれますいずれかのセグメントがリクエストされた場合、レスポンスには、セグメントリソースタプルごとに追加の行も表示されます。

使用可能なフィールドとリソースに関するメタデータ

GoogleAdsFieldService

このサービスでは、クエリ可能フィールドのカタログに、その互換性とタイプに関する詳細が提供されます。

GoogleAdsFieldService クエリの結果は、 GoogleAdsField 個のインスタンスで、リクエストされたフィールドの詳細を含む GoogleAdsField。

リソースの属性のクエリ

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

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id

このクエリは、キャンペーン ID で並べ替えます。結果の GoogleAdsRow はそれぞれ以下を表します。選択したフィールド（指定したフィールドを含む）が入力された campaign オブジェクト resource_name）を入力します。

キャンペーンのクエリで使用できるその他のフィールドについては、 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」のキャンペーンのみを表示します。キャンペーン ID で並べ替えることができます。各結果の GoogleAdsRow の metrics フィールドには、選択します。

クエリ可能な指標のリストについては、Metrics ドキュメントをご覧ください。

セグメントのクエリ

特定のリソースに対して選択した属性の他に、関連セグメント:

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 を超えているただし、このクエリはデータを日付別に分割します。その結果 GoogleAdsRow はキャンペーンのタプルを表し、日付は Segment です。です。選択した指標は分割されますセグメントに分割されます。

クエリ可能なセグメントのリストについては、Segments ドキュメントをご覧ください。

クエリ結果に基づく変更

特定のリソースをクエリする際、返されたリソースをすぐに取得して結果をオブジェクトに変換して変更し指定する必要があります。ワークフローの例を以下に示します。

ステータスが「PAUSED」でインプレッション数が 1,000 を上回っているとします。
各 GoogleAdsRow の campaign フィールドから Campaign オブジェクトを取得します。返されます。
各キャンペーンのステータスを PAUSED から ENABLED に変更します。
CampaignService.MutateCampaigns を呼び出す更新して更新されます

フィールドメタデータ

GoogleAdsFieldService に送信されるクエリは、フィールドメタデータを取得するためのものです。この情報により、フィールドを一緒に使用する方法を理解できます。特定しますデータは API から利用でき、必要なメタデータが用意されており、デベロッパーはこれを使用して、必要があります。こちらが一般的なメタデータのクエリ:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"

このクエリの <INSERT_RESOURCE_OR_FIELD> は、リソース（customer、campaign など）またはフィールド（campaign.id、 metrics.impressions、ad_group.id など）。

クエリ可能なフィールドの一覧については、GoogleAdsField ドキュメントをご覧ください。

コードの例

クライアントライブラリに、 GoogleAdsService での Google 広告クエリ言語。basic operations フォルダには次のオペレーションがあります。（GetCampaigns、GetKeywords、SearchForGoogleAdsFields など）。 reporting フォルダには GetKeywordStats の例があります。

クエリ文法