इस उदाहरण में, 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
ध्यान दें: API Explorer में यह अनुरोध पूरा करने के लिए, आपको pageToken
पैरामीटर की वैल्यू अपडेट करनी पड़ सकती है. pageToken
पैरामीटर की सही वैल्यू पाने के लिए, पहले 10 नतीजे दिखाने वाली क्वेरी को चलाएं.