ตัวอย่างต่อไปนี้สาธิตวิธีการส่งคําขอการค้นหาประเภทต่างๆ ใน API v3
วิดีโอ
ตัวอย่างนี้เรียกใช้เมธอด search.list
เพื่อค้นหาวิดีโอความละเอียดสูง (HD) ที่มียอดดูสูงสุดซึ่งเชื่อมโยงกับการค้นหา "สุนัขเล่นสเก็ตบอร์ด" การค้นหาตั้งค่าพารามิเตอร์ order
, part
, q
, type
และ videoDefinition
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &order=viewCount &q=skateboarding+dog &type=video &videoDefinition=high
ดูตัวอย่างโค้ดได้จากเอกสารประกอบของเมธอด search.list
เพลย์ลิสต์
ตัวอย่างนี้แสดงวิธีค้นหาเพลย์ลิสต์ที่ตรงกับข้อความค้นหา "GoogleDeveloper" โดยเรียกใช้เมธอด search.list
และกําหนดค่าของพารามิเตอร์ type
เป็น playlist
เพื่อให้ชุดผลลัพธ์มีเฉพาะเพลย์ลิสต์เท่านั้น
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=GoogleDevelopers &type=playlist
ช่อง
ตัวอย่างนี้แสดงวิธีค้นหาช่องที่ตรงกับข้อความค้นหา "เดินทาง" โดยเรียกใช้เมธอด search.list
และกําหนดค่าของพารามิเตอร์ type
เป็น channel
เพื่อให้ชุดผลลัพธ์มีเฉพาะแชแนลเท่านั้น
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=travel &type=channel
ผลการค้นหาที่เกี่ยวข้องกับภาษาเฉพาะ
ตัวอย่างนี้เรียกเมธอด search.list
เพื่อค้นหาผลการค้นหาที่เกี่ยวข้องกับภาษาหนึ่งๆ มากที่สุด ตัวอย่างแสดงให้เห็นว่าข้อความค้นหาคือทะเล (q=marine
) และการตอบกลับของ API ควรมีผลการค้นหาที่เกี่ยวข้องกับภาษาฝรั่งเศสมากที่สุด (relevanceLanguage=fr
)
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=marine &relevanceLanguage=fr
โปรดทราบว่าคําขอไม่ได้ตั้งค่าสําหรับพารามิเตอร์ type
ซึ่งหมายความว่าผลการค้นหาแต่ละรายการอาจอ้างอิงวิดีโอ เพลย์ลิสต์ หรือช่อง
วิดีโอที่อัปโหลดผ่านแอปหรือเว็บไซต์ของนักพัฒนาแอป
ตัวอย่างนี้แสดงวิธีใช้พารามิเตอร์ forDeveloper
เพื่อจํากัดการค้นหาให้ดึงเฉพาะวิดีโอที่อัปโหลดผ่านแอปพลิเคชันหรือเว็บไซต์ของนักพัฒนาแอปเท่านั้น พารามิเตอร์นี้สามารถใช้ร่วมกับพารามิเตอร์การค้นหาที่ไม่บังคับ เช่น พารามิเตอร์ q
หมายเหตุ: คําค้นหานี้ไม่ได้แสดงผลการค้นหาจริงใน API Explorer เนื่องจาก API Explorer ยังไม่รองรับการอัปโหลดวิดีโอ คุณสามารถเรียกใช้การสืบค้นข้อมูลนี้สําหรับแอปพลิเคชันของคุณเองนอก API Explorer ได้ แต่จะไม่สามารถดูผลลัพธ์สําหรับแอปพลิเคชันของคุณที่ใช้ API Explorer ได้
วิดีโอที่อัปโหลดแต่ละรายการจะติดแท็กโดยอัตโนมัติด้วยหมายเลขโปรเจ็กต์ที่เชื่อมโยงกับแอปพลิเคชันของนักพัฒนาแอปในคอนโซล Google API
เมื่อคําขอการค้นหาตั้งค่าพารามิเตอร์ forDeveloper
เป็น "จริง" ในภายหลัง บริการ API จะใช้ข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคําขอเพื่อระบุนักพัฒนาซอฟต์แวร์ ด้วยเหตุนี้ นักพัฒนาเกมจึงจํากัดผลการค้นหาได้เฉพาะวิดีโอที่อัปโหลดผ่านแอปหรือเว็บไซต์ของนักพัฒนาแอปเอง แต่ไม่จํากัดเฉพาะวิดีโอที่อัปโหลดผ่านแอปหรือเว็บไซต์อื่นๆ
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=fun &forDeveloper=true