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

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

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