Paginate query results

השאילתה של Merchant Center שפה מספקת את האפשרויות הבאות שדות לעימוד:

• pageSize: מספר השורות המקסימלי לאחזור בבקשה יחידה. ברירת המחדל היא 1,000 שורות.
• pageToken: האסימון של הדף שצריך להחזיר. אם לא צוין, המערכת הדף מוחזר.
• nextPageToken: הערך pageToken כדי לקבל את הדף הבא accounts.reports.search שיחה.

כשמציינים pageToken, כל הפרמטרים האחרים בשיחה צריכים להתאים כדי למנוע התנהגות בלתי צפויה.

לדוגמה, אם מריצים את השאילתה הבאה בחשבון שיש בו 100,000 ערכי offerId, והערך pageSize מוגדר ל-200, התוצאה מכילה רק 200 ReportRow אובייקטים בתגובה הראשונה, יחד עם nextPageToken:

SELECT offerId, impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2021-12-01' AND '2021-12-31'

לפניכם תגובה לדוגמה (חמש התוצאות הראשונות nextPageToken):

{
  "results": [
    {
      "productPerformanceView": {
        "offerId": "12345",
        "clicks": "0",
        "impressions": "59",
        "clickThroughRate": 0
      }
    },
    {
      "productPerformanceView": {
        "offerId": "12346",
        "clicks": "9625",
        "impressions": "276695",
        "clickThroughRate": 0.034785594246372356
      }
    },
    {
      "productPerformanceView": {
        "offerId": "12347",
        "clicks": "148",
        "impressions": "22045",
        "clickThroughRate": 0.0067135404853708325
      }
    },
    {
      "productPerformanceView": {
        "offerId": "12348",
        "clicks": "11",
        "impressions": "1100",
        "clickThroughRate": 0.01
      }
    },
    {
      "productPerformanceView": {
        "offerId": "12349",
        "clicks": "569",
        "impressions": "62977",
        "clickThroughRate": 0.0090350445400701838
      }
    },
    ...
  ],
  "nextPageToken": "CMgB"
}

כדי לאחזר את 200 השורות הבאות, שולחים שוב את הבקשה באותו גודל דף, אבל לעדכן את pageToken של הבקשה ל-nextPageToken מ- לתשובה.

נקודה חשובה: nextPageToken לא מאוכלס בתשובה שמכילה קבוצת השורות האחרונה.