מעבר בין דפי התוצאות

אפשר לעבור בין התוצאות שאוחזרו באמצעות GoogleAdsService.Search במקום להוריד את כל מערך התוצאות בבת אחת. סקירה כללית על דיווח באמצעות Google Ads API מופיעה במאמר סקירה כללית על דיווח.

‫Search מחזירה דפים קבועים של עד 10,000 שורות. ההגדרה page_size ב-SearchGoogleAdsRequest הוצאה משימוש ומחזירה את השגיאה RequestError.PAGE_SIZE_NOT_SUPPORTED.

שאילתה וחלוקה לדפים לדוגמה

נניח שיש לכם את השאילתה הבאה:

SELECT
  ad_group.id,
  ad_group_criterion.type,
  ad_group_criterion.criterion_id,
  ad_group_criterion.keyword.text,
  ad_group_criterion.keyword.match_type
FROM ad_group_criterion
WHERE ad_group_criterion.type = KEYWORD

אם החשבון שלכם מכיל 50,000 מילות מפתח, קבוצת התוצאות תכיל 10,000 אובייקטים מסוג GoogleAdsRow בתשובה הראשונה, יחד עם next_page_token.

כדי לאחזר את 10,000 השורות הבאות, שולחים את הבקשה שוב, אבל מעדכנים את page_token של הבקשה ל-next_page_token של התגובה:

{
  "query": "SELECT ad_group.id, ad_group_criterion.type, ad_group_criterion.criterion_id, ad_group_criterion.keyword.text, ad_group_criterion.keyword.match_type FROM ad_group_criterion WHERE ad_group_criterion.type = KEYWORD",
  "pageToken": "CN3q9...example_token..."
}

הערה: הערך next_page_token לא מאוכלס בתגובה שמכילה את קבוצת השורות האחרונה.

ספריות הלקוח שלנו מטפלות בחלוקה לדפים באופן אוטומטי. צריך רק לבצע איטרציה בשורות של התשובה. כשכל השורות בדף הנוכחי מוחזרות, ספריית הלקוח מאחזרת באופן אוטומטי דף חדש של שורות בשמכם, עד שכל מערך הנתונים מאוחזר. אם משתמשים ב-REST במקום ב-gRPC, צריך לשלוח בקשה לכל דף חדש.

שמירה במטמון ותוקף של טוקן דף

מערכת Google Ads API שומרת במטמון את מערך הנתונים, כך שבקשות עתידיות לדפים יהיו מהירות יותר מהבקשה הראשונית. שימו לב: לערכים של next_page_token יש אורך חיים מוגבל (TTL), והם יפוגו אם לא תשתמשו בהם תוך תקופה קצרה (בערך שעתיים). אם פג התוקף של אסימון דף, ה-API מחזיר שגיאה וצריך להתחיל שאילתה חדשה.

כדי לנצל את הנתונים שבמטמון, השאילתה צריכה להיות זהה בבקשות הבאות. בקשות עמודים עוקבות לא נספרות כפעולות נוספות במכסת הפעולות היומית של גישת Explorer ושל גישה בסיסית. אם השאילתה שונה ונשלחת עם אותו טוקן דף, מוחזרת שגיאה.