Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Sipariş sonuçları
Virgülle ayrılmış bir veya daha fazla sıralamadan oluşan ORDER BY
ifadesini kullanarak yanıtınızdaki satırların sırasını belirtebilirsiniz:
FieldName ('ASC' | 'DESC')?
Bir alan adından sonra ASC
veya DESC
belirtmezseniz Google Ads API varsayılan olarak ASC
değerini kullanır.
Aşağıdaki ORDER BY
ifadesi, kampanya düzeyindeki bir raporu azalan gösterim sayısına ve artan kampanya adına göre sıralar:
ORDER BY metrics.impressions DESC, campaign.name ASC
Sipariş vermeye izin verilmez:
- Seçili olmayan kaynakların özelliklerine göre
- Seçilmeyen metriklere göre
- Seçilmeyen segmentlere göre
- Aşağıdaki türlerdeki alanlar için:
MESSAGE
- Yinelenen alanlar
- Yinelenen alanların özellikleri
Sonuç sayısını sınırlama
LIMIT
koşulunu kullanarak döndürülen toplam sonuç sayısını sınırlayabilirsiniz.
Bunu sonuç sıralamasıyla birleştirerek "en iyi N" raporları oluşturabilirsiniz. Örneğin, son 30 günde en yüksek gösterime sahip beş kampanyayı içeren bir rapor:
SELECT
campaign.id,
campaign.name,
metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 5
Filtrelemeye izin verilmez:
- "Temel" tarih segmenti alanları hariç olmak üzere, segmentler seçilmeden.
- Temel tarih segmenti alanları
segments.date
, segments.week
, segments.month
, segments.quarter
ve segments.year
'dir.
- Temel türler (ör. Int64Value, StringValue vb.)
- Basitler dışındaki herhangi bir ileti türünün yinelenen alan özelliklerinde (ör.
Int64Value, StringValue vb.)
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-27 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-27 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.)"]]