การใช้งาน: การใส่เลขหน้า

ตัวอย่างต่อไปนี้แสดงวิธีเรียกชุดผลลัพธ์เพิ่มเติมสําหรับการค้นหา YouTube Data API (v3)

API จะใช้พารามิเตอร์ maxResults เพื่อระบุจํานวนรายการที่ควรรวมอยู่ในการตอบกลับ API เมธอด list ของ API (videos.list, playlists.list ฯลฯ) เกือบทั้งหมดรองรับพารามิเตอร์นั้น

หากมีผลลัพธ์เพิ่มเติมสําหรับคําค้นหา การตอบกลับ API จะมีพร็อพเพอร์ตี้ nextPageToken, พร็อพเพอร์ตี้ prevPageToken หรือทั้ง 2 รายการ จากนั้นจะสามารถใช้ค่าของพร็อพเพอร์ตี้เหล่านั้นเพื่อตั้งค่าพารามิเตอร์ 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 เรียกใช้คําค้นหาที่ดึงผลลัพธ์ 10 รายการแรกเพื่อให้ได้ค่าพารามิเตอร์ pageToken ที่ถูกต้อง