تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ترتيب النتائج
يمكنك تحديد ترتيب الصفوف في ردّك باستخدام عبارة ORDER BY،
التي تتألف من تسلسل واحد أو أكثر مفصول بفواصل من:
FieldName ('ASC' | 'DESC')?
إذا لم تحدّد ASC أو DESC بعد اسم حقل، سيتم تلقائيًا ضبط القيمة ASC في Google Ads API.
ترتّب عبارة ORDER BY التالية تقريرًا على مستوى الحملة حسب عدد مرّات الظهور من الأعلى إلى الأدنى واسم الحملة من الأبجدية إلى الياء:
ORDER BY metrics.impressions DESC, campaign.name ASC
لا يُسمح بالطلب في الحالات التالية:
- حسب سمات المراجع غير المحدّدة
- حسب المقاييس غير المحدّدة
- حسب الشرائح غير المحدّدة
- بالنسبة إلى الحقول من الأنواع التالية:
MESSAGE- الحقول المتكرّرة
- سمات الحقول المتكرّرة
الحدّ من عدد النتائج
يمكنك الحدّ من إجمالي عدد النتائج المعروضة باستخدام عبارة LIMIT.
من خلال الجمع بين هذا الإجراء وترتيب النتائج، يمكنك إنشاء تقارير "أفضل N"، مثل تقرير يتضمّن الحملات الخمس التي حقّقت أعلى عدد من مرّات الظهور خلال آخر 30 يومًا:
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 وما إلى ذلك)
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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.)"]]
