מיון והגבלת תוצאות

מיון התוצאות

אפשר לציין את סדר השורות בתגובה באמצעות התנאי 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 וכו')