דפדוף בין התוצאות

אפשר לעבור בין התוצאות שאוחזרו באמצעות GoogleAdsService.Search במקום להוריד את כל קבוצת התוצאות בבת אחת. סקירה כללית על דיווח באמצעות Google Ads API זמינה במדריך הדיווח.

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

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

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