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

‫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 שומרת במטמון באופן פנימי את כל מערך הנתונים, כך שהבקשות הבאות מהירות יותר מהבקשה הראשונית.

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