Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Urutkan hasil
Anda dapat menentukan urutan baris dalam respons menggunakan klausa ORDER BY
,
yang terdiri dari satu atau beberapa urutan yang dipisahkan koma:
FieldName ('ASC' | 'DESC')?
Jika Anda tidak menentukan ASC
atau DESC
setelah nama kolom, Google Ads API akan menggunakan ASC
secara default.
Klausul ORDER BY
berikut mengurutkan laporan tingkat kampanye menurut tayangan iklan menurun dan nama kampanye menaik:
ORDER BY metrics.impressions DESC, campaign.name ASC
Pengurutan tidak diizinkan:
- Menurut atribut resource yang tidak dipilih
- Menurut metrik yang tidak dipilih
- Menurut segmen yang tidak dipilih
- Untuk kolom dengan jenis berikut:
MESSAGE
- Kolom berulang
- Atribut kolom berulang
Membatasi jumlah hasil
Anda dapat membatasi jumlah total hasil yang ditampilkan menggunakan klausa LIMIT
.
Dengan menggabungkan ini dengan pengurutan hasil, Anda dapat membuat laporan "N teratas", seperti laporan yang berisi lima kampanye dengan tayangan iklan 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 kolom segmen tanggal "inti".
- Kolom segmen tanggal inti adalah
segments.date
, segments.week
,
segments.month
, segments.quarter
, dan segments.year
.
- Di kolom jenis pesan apa pun kecuali primitif (misalnya: Int64Value, StringValue, dll.)
- Pada atribut kolom berulang dari jenis pesan apa pun kecuali primitif (misalnya:
Int64Value, StringValue, dll.)
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-09-05 UTC.
[null,null,["Terakhir diperbarui pada 2025-09-05 UTC."],[[["\u003cp\u003eYou can control the order of results using the \u003ccode\u003eORDER BY\u003c/code\u003e clause, specifying fields and sort direction (ASC or DESC).\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eLIMIT\u003c/code\u003e clause lets you restrict the number of returned results, enabling "top N" reports when combined with \u003ccode\u003eORDER BY\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eOrdering is disallowed by attributes of non-selected resources, by non-selected metrics or segments, and for fields of type \u003ccode\u003eMESSAGE\u003c/code\u003e, repeated fields, or attributes of repeated fields.\u003c/p\u003e\n"],["\u003cp\u003eFiltering is restricted for segments without selection (excluding core date segments), fields of non-primitive message types, and attributes of repeated fields with non-primitive message types.\u003c/p\u003e\n"]]],[],null,["Order results\n-------------\n\nYou can specify the order of rows in your response using the `ORDER BY` clause,\nwhich consists of one or more comma-separated sequences of: \n\n FieldName ('ASC' | 'DESC')?\n\nIf you don't specify `ASC` or `DESC` after a field name, the Google Ads API defaults to\n`ASC`.\n\nThe following `ORDER BY` clause sorts a campaign-level report by descending\nimpressions and ascending campaign name: \n\n ORDER BY metrics.impressions DESC, campaign.name ASC\n\nOrdering is not allowed:\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n- By attributes of non-selected resources\n- By non-selected metrics\n- By non-selected segments\n- For fields of the following types:\n - `MESSAGE`\n - Repeated fields\n - Attributes of repeated fields\n\nLimit the number of results\n---------------------------\n\nYou can limit the total number of results returned using the `LIMIT` clause.\nCombining this with results ordering, you can produce \"top N\" reports,\nsuch as a report containing the five campaigns with the highest impressions\nover the last 30 days: \n\n SELECT\n campaign.id,\n campaign.name,\n metrics.impressions\n FROM campaign\n WHERE segments.date DURING LAST_30_DAYS\n ORDER BY metrics.impressions DESC\n LIMIT 5\n\nFiltering is not allowed:\n\n- On segments without selecting them, except for \"core\" date segment fields.\n - The core date segment fields are `segments.date`, `segments.week`, `segments.month`, `segments.quarter`, and `segments.year`.\n- On fields of any message type except primitives (e.g.: Int64Value, StringValue, etc.)\n- On attributes of repeated fields of any message type except primitives (e.g.: Int64Value, StringValue, etc.)"]]