הטמעה: חלוקה לדפים

הדוגמה הבאה מראה איך לאחזר קבוצות נוספות של תוצאות לשאילתות של YouTube Data API (גרסה 3).

ה-API משתמש בפרמטר maxResults כדי לציין כמה פריטים צריך לכלול בתגובת ה-API. כמעט כל השיטות של list ב-API (videos.list,‏ playlists.list וכו') תומכות בפרמטר הזה.

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

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

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &maxResults=10
        &order=viewCount
        &q=skateboarding+dog
        &type=video

תגובת ה-API מכילה את 10 ההתאמות הראשונות לשאילתה, וגם את המאפיין nextPageToken שאפשר להשתמש בו כדי לאחזר את 10 התוצאות הבאות:

השאילתה הבאה מאחזרת את 10 התוצאות הבאות של השאילתה:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &maxResults=10
        &order=viewCount
        &pageToken=CAoQAA
        &q=skateboarding+dog
        &type=video

הערה: יכול להיות שתצטרכו לעדכן את הערך של הפרמטר pageToken כדי להשלים את הבקשה הזו ב-API Explorer. מריצים את השאילתה שמאחזרת את 10 התוצאות הראשונות כדי לקבל את ערך הפרמטר pageToken הנכון.