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

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

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

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