דפדוף בין התוצאות

‫GoogleAdsService.Search תומך בהחלפת דפים בגודל דף קבוע של 10,000 שורות. קבוצת התוצאות של השאילתה מחולקת לכמה תגובות, שכל אחת מהן מכילה 10,000 אובייקטים.

לדוגמה, נניח שיש לכם את השאילתה הבאה:

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 של התגובה. הערה: הערך של next_page_token לא מאוכלס בתגובה שמכילה את קבוצת השורות האחרונה.

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

מערכת Google Ads API שומרת במטמון באופן פנימי את כל מערך הנתונים, כך שהבקשות הבאות מהירות יותר מהבקשה הראשונית.

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