クエリの構造

指標フィールドとセグメント フィールドのクエリは、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 valueWHERE では任意のセグメント フィールドを使用できます できます。ただし、指標フィールドを 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 または DESCASCDESC も指定されていない場合、順序はデフォルトで 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