結果の並べ替えと制限

ORDER BY 句を使用して、レスポンス内の行の順序を指定できます。これは、次の 1 つ以上のコンマ区切りのシーケンスで構成されます。

FieldName ('ASC' | 'DESC')?

フィールド名の後に ASC や DESC を指定しない場合、Reporting API はデフォルトで ASC になります。

次の ORDER BY 句は、インプレッションを降順、商品提案 ID を昇順で、パフォーマンス レポートを並べ替えます。

ORDER BY metrics.impressions DESC, segments.offer_id ASC

選択されていない指標または選択されていないセグメントでは、ORDER BY は使用できません。

結果の数を制限する

LIMIT 句を使用して返される結果の総数を制限できます。これを結果の並べ替えと組み合わせると、過去 30 日間で最もインプレッションが多い 5 つの商品を含むレポートなど、「上位 N」のレポートを作成できます。

例

SELECT
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-31'
ORDER BY metrics.impressions DESC
LIMIT 5;

注: 上限がこれより高くても、クエリから取得できる最大行数は 1, 000 行です。残りの結果に対して pageToken を使用して連続してリクエストを発行する必要があります。詳しくは、ページネーション ガイドをご覧ください。

指標を選択せずにフィルタリング（WHERE 句）することはできません。