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