Mengurutkan dan Membatasi Hasil

Hasil pengurutan

Anda dapat menentukan urutan baris dalam respons menggunakan klausa ORDER BY, yang terdiri dari satu atau beberapa urutan yang dipisahkan koma dari:

FieldName ('ASC' | 'DESC')?

Jika Anda tidak menentukan ASC atau DESC setelah nama kolom, Google Ads API akan secara default ke ASC.

Klausa ORDER BY berikut mengurutkan laporan tingkat kampanye secara menurun tayangan dan nama kampanye menaik:

ORDER BY metrics.impressions DESC, campaign.name ASC

Pengurutan tidak diizinkan:

  • Dengan atribut resource yang tidak dipilih
  • Menurut metrik yang tidak dipilih
  • Menurut segmen yang tidak dipilih
  • Untuk kolom jenis berikut:
    • MESSAGE
    • Kolom berulang
    • Atribut kolom berulang

Membatasi jumlah hasil

Anda dapat membatasi jumlah total hasil yang ditampilkan menggunakan klausa LIMIT. Menggabungkan ini dengan pengurutan hasil, Anda dapat menghasilkan "top N" laporan, seperti laporan yang berisi lima kampanye dengan tayangan tertinggi selama 30 hari terakhir:

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

Pemfilteran tidak diizinkan:

  • Pada segmen tanpa memilihnya, kecuali untuk "inti" bidang segmen tanggal.
    • Kolom segmen tanggal inti adalah segments.date, segments.week, segments.month, segments.quarter, dan segments.year.
  • Pada kolom jenis pesan apa pun kecuali primitif (misalnya: Int64Value, StringValue, dll.)
  • Pada atribut kolom berulang jenis pesan apa pun kecuali primitif (misalnya: Int64Value, StringValue, dll.)