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

ตัวอย่างต่อไปนี้สาธิตวิธีส่งคำขอการค้นหาประเภทต่างๆ ใน v3 API

วิดีโอ

ตัวอย่างนี้จะเรียกใช้เมธอด 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

เพลย์ลิสต์

ตัวอย่างนี้แสดงวิธีค้นหาเพลย์ลิสต์ที่ตรงกับข้อความค้นหา "GoogleDevelopers" โดยเรียกใช้เมธอด search.list และตั้งค่าพารามิเตอร์ type เป็น playlist เพื่อให้ชุดผลลัพธ์มีเฉพาะเพลย์ลิสต์

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=GoogleDevelopers
        &type=playlist

ช่อง

ตัวอย่างนี้แสดงวิธีค้นหาช่องที่ตรงกับข้อความค้นหา "travel" โดยเรียกใช้เมธอด search.list และตั้งค่าพารามิเตอร์ type เป็น channel เพื่อให้ชุดผลลัพธ์มีเฉพาะแชแนล

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=travel
        &type=channel

ผลการค้นหาที่เกี่ยวข้องกับภาษาหนึ่งๆ

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

วิดีโอที่อัปโหลดแต่ละรายการจะได้รับแท็กหมายเลขโปรเจ็กต์ที่เชื่อมโยงกับแอปพลิเคชันของนักพัฒนาแอปใน คอนโซล Google API โดยอัตโนมัติ

เมื่อคำขอค้นหาตั้งค่าพารามิเตอร์ forDeveloper เป็น true ในภายหลัง บริการ API จะใช้ข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอเพื่อระบุนักพัฒนาแอป ดังนั้น นักพัฒนาแอปจึงจำกัดผลการค้นหาให้แสดงเฉพาะวิดีโอที่อัปโหลดผ่านแอปหรือเว็บไซต์ของตนเองได้ แต่จะจำกัดให้แสดงเฉพาะวิดีโอที่อัปโหลดผ่านแอปหรือเว็บไซต์อื่นๆ ไม่ได้

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=fun
        &forDeveloper=true