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

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

วิดีโอ

ตัวอย่างนี้เรียกใช้เมธอด search.list เพื่อค้นหาวิดีโอความละเอียดสูง (HD) ที่มีผู้เข้าชมมากที่สุดซึ่งเชื่อมโยงกับคำค้นหา "skateboarding dog" คำค้นหาจะตั้งค่าพารามิเตอร์ 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 Cloud โดยอัตโนมัติ

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

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