הטמעה: עימוד

הדוגמה הבאה מראה איך לאחזר עוד קבוצות של תוצאות לשאילתות של YouTube Data API (v3).

ממשק ה-API משתמש בפרמטר maxResults כדי לציין כמה פריטים יש לכלול בתגובת API. כמעט כל השיטות של ממשק ה-API של list (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 כדי להשלים את הבקשה הזו ב-APIs Explorer. מריצים את השאילתה שמאחזרת את 10 התוצאות הראשונות כדי לקבל את ערך הפרמטר pageToken הנכון.