नीचे दिए गए उदाहरण में, YouTube Data API (v3) क्वेरी के लिए, नतीजों के अन्य सेट वापस पाने का तरीका बताया गया है.
एपीआई, maxResults
पैरामीटर का इस्तेमाल करके यह बताता है कि एपीआई रिस्पॉन्स में कितने आइटम शामिल किए जाने चाहिए. एपीआई की करीब list
तरीकों (videos.list
, playlists.list
वगैरह) में यह पैरामीटर काम करता है.
अगर किसी क्वेरी के लिए और नतीजे उपलब्ध हैं, तो एपीआई रिस्पॉन्स में 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
एपीआई के जवाब में, क्वेरी के पहले 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
पैरामीटर की वैल्यू को अपडेट करना पड़ सकता है. सही pageToken
पैरामीटर वैल्यू पाने के लिए, पहले 10 नतीजों को वापस लाने वाली क्वेरी चलाएं.