結果を並べ替える

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

FieldName ('ASC' | 'DESC')?

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

次の ORDER BY 句は、インプレッションを降順、キャンペーン名を昇順で、キャンペーン単位のレポートを並べ替えます。

ORDER BY metrics.impressions DESC, campaign.name ASC

次の条件での並べ替えは許可されていません。

• 選択されていないリソースの属性別
• 選択されていない指標別
• 選択されていないセグメント別
• 次のタイプのフィールド:
  • MESSAGE
  • 繰り返しフィールド
  • 繰り返しフィールドの属性

結果の数を制限する

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

SELECT
  campaign.id,
  campaign.name,
  metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 5

次のフィルタは許可されていません。

• 選択していないセグメント。「中核となる」日付セグメント フィールドは例外です。
  • 「中核となる」日付セグメント フィールドは、segments.date、segments.week、segments.month、segments.quarter、segments.year です。
• メッセージ タイプのフィールド。プリミティブ（例: Int64Value、StringValue など）は例外です。
• メッセージ タイプの繰り返しフィールドの属性。プリミティブ（例: Int64Value、StringValue など）は例外です。