ตัวอย่างต่อไปนี้แสดงวิธีเรียกชุดผลลัพธ์เพิ่มเติมสําหรับการค้นหา 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
ที่ถูกต้อง