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

クエリの構造

指標フィールドとセグメントフィールドのクエリは、reports.search に送信できます。メソッドを呼び出します。Merchant Center のクエリ言語でクエリを作成するには、まず言語文法を使用して質問します。クエリは複数の句で構成されます。

SELECT
FROM
WHERE
ORDER BY
LIMIT

句ではフィールド名、テーブル名、演算子、条件を使用します。順序を使用して、目的のデータを選択できます。統合すると Google Content API for Shopping を使ってリクエストできます。では、それぞれの Pod が句を使用できます。

句

SELECT

SELECT 句は、リクエストで取得するフィールドのセットを指定します。SELECT セグメントフィールドと指標のカンマ区切りのリストを受け取り、返されます。クエリには SELECT 句が必須です。

特定のテーブルからクリック指標を選択するサンプルクエリを次に示します。

SELECT
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

1 つのリクエストでさまざまなフィールドタイプをクエリすることもできます。

SELECT
  segments.date,
  segments.program,
  metrics.impressions,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

区画の分割
- segments.date
- segments.program
指標
- metrics.impressions
- metrics.clicks

次の理由により、一部のフィールドは SELECT 句で使用できません。制限：

指標フィールドを 1 つもないセグメントフィールドをクエリする場合。

上記の状態に関連する情報については、リファレンスドキュメントをご覧ください。

FROM

FROM 句には、リクエストでデータを取得するテーブルを指定します。「 FROM 句のテーブルは、他のすべてのテーブルで使用できるフィールドを定義します。句を使用します。テーブルに指定できるテーブルは 1 つのみです。 FROM 句。現在サポートされているのは MerchantPerformanceView テーブルのみです。 FROM 句は、search メソッドに対するクエリでは必須です。 reports サービス。

WHERE

WHERE 句では、次の条件でデータをフィルタする場合に適用する条件を指定します。リクエストできます。WHERE 句を使用する場合は、1 つ以上の条件を指定できます。 AND を使用して分離します。各条件は、次のパターンに従う必要があります。 field_name Operator value。WHERE では任意のセグメントフィールドを使用できますできます。ただし、指標フィールドを SELECT 句で指定しなければ、 WHERE 句で使用されます。クエリでは WHERE 句は必須です。オーディエンスのターゲティングを確実に行うにはパフォーマンスデータが返されます

以下は、与えられた期間の指標を返すために WHERE を使用したサンプルです。

SELECT
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

複数の条件を組み合わせてデータをフィルタできます。この例では、 SHOPPING_ADS プログラムでの商品あたりのクリック数 100 を超える数のアセットが存在します。

SELECT
  segments.offer_id,
  segments.program,
  metrics.clicks
FROM MerchantPerformanceView
WHERE metrics.clicks > 100
  AND segments.program = SHOPPING_ADS
  AND segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’;

次のクエリでは、segments.date が選択されています。 segments.date を選択するかどうかに関係なく、パフォーマンスデータを取得するには、WHERE 句を常に指定する必要があります。

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

フィルタする際は、演算子で大文字と小文字を区別することが重要です。考えています

演算子の完全なリストについては、言語文法。

ORDER BY

ORDER BY 句は、結果が表示される順序を指定します。返されます。これにより、フィールド名に基づいてデータを昇順または降順に並べ替えることができます。各順序は、field_name で指定し、その後に ASC または DESC。ASC も DESC も指定されていない場合、順序はデフォルトで ASC に送信します。SELECT 句で指定されたフィールドのみを ORDER BY 句。クエリでは ORDER BY 句は省略可能です。

次のクエリは、返された行をクリック数の多い順に並べます最低:

SELECT
  segments.offer_id,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
ORDER BY metrics.clicks DESC

ORDER BY 句では、カンマで区切って複数のフィールドを指定できます。選択します。並べ替えはクエリで指定された順序で行われます。たとえば、このクエリでは結果が昇順で並べ替えられます。 offer_id、次にインプレッション数の降順で、その後はクリック数の降順:

SELECT
  segments.offer_id,
  metrics.impressions,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
ORDER BY
  segments.offer_id,
  metrics.impressions DESC,
  metrics.clicks DESC

LIMIT

LIMIT 句を使用すると、返される結果の数を指定できます。これは、要約にのみ関心がある場合に便利です。

たとえば、LIMIT を使用して、次のクエリの結果の総数を制限できます。

SELECT
  segments.program,
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
ORDER BY metrics.impressions DESC
LIMIT 50

クエリ文法

期間