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

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