ב-GoogleAdsService.Search אפשר לציין page_size בבקשה להצגת דפים.
הפעולה הזו מפצלת את קבוצת התוצאות של השאילתה למספר תגובות, שכל אחת מהן מכילה מספר page_size של אובייקטים. אם לא צוין page_size, הוא מוגדר אוטומטית למקסימום של 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 מילות מפתח והערך page_size מוגדר ל-1,000, קבוצת התוצאות תכיל 1,000 אובייקטים של GoogleAdsRow בתגובה הראשונה, יחד עם next_page_token.
כדי לאחזר את אלף השורות הבאות, צריך לשלוח שוב את הבקשה באותו גודל דף, אבל לעדכן את page_token של הבקשה לערך next_page_token של התשובה. הערך של page_size בבקשות הבאות עשוי להיות שונה בכל פעם. שימו לב שהשדה next_page_token לא מאוכלס בתשובה שמכילה את אצווה השורות האחרונה.
ספריות הלקוח שלנו מטפלות בהחלפה אוטומטית. צריך לבצע חזרה רק באמצעות השורות של התשובה. אחרי שכל השורות בדף הנוכחי מוחזרות, ספריית הלקוח מאחזרת בשמכם באופן אוטומטי דף חדש של שורות עד שכל קבוצת הנתונים מאוחזרת. אם משתמשים ב-REST במקום ב-gRPC, צריך לשלוח בקשה מפורשת לכל דף חדש.
Google Ads API שומר באופן פנימי את כל קבוצת הנתונים, כך שהבקשות הבאות מהירות יותר מהבקשות הראשוניות. בהתאם לתרחיש לדוגמה שלכם, תוכלו להגדיר את page_size לכל ערך בין 1 ל-10,000. באופן כללי, כדי שהביצועים הכוללים יהיו מהירים יותר, מומלץ להשתמש ב-page_size גדול יותר למספר קטן יותר של נסיעות הלוך ושוב.
כדי לנצל את הנתונים שנשמרו במטמון, השאילתה שלכם צריכה להישאר זהה בבקשות הבאות, ובמיוחד הבקשות לגישה בסיסית, שלא ייכללו במכסה שלכם. אם השאילתה שונה ונשלחת יחד עם אותו אסימון דף, מוחזר שגיאה.