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

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

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

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