การใช้งาน: คําขอการค้นหา

ตัวอย่างต่อไปนี้สาธิตวิธีการส่งคําขอการค้นหาประเภทต่างๆ ใน 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