קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
סדר התוצאות
אפשר לציין את סדר השורות בתגובה באמצעות פסקה ORDER BY
, שמורכבת מרצף אחד או יותר של:
FieldName ('ASC' | 'DESC')?
אם לא מציינים ASC
או DESC
אחרי שם של שדה, ברירת המחדל של Google Ads API היא ASC
.
הפסקה 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-09-05 (שעון UTC).
[null,null,["עדכון אחרון: 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.)"]]