סדר התוצאות

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