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

תוצאות לפי סדר

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