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

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

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