דפדוף בתוצאות

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

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