Các ví dụ sau đây minh hoạ cách hoàn tất một số loại yêu cầu tìm kiếm trong API v3.
Video
Ví dụ này gọi phương thức search.list để tìm các video có độ phân giải cao (HD) được xem nhiều nhất, có liên quan nhất đến truy vấn "Trượt băng trượt băng". Truy vấn đặt các thông số order, part, q, type và videoDefinition.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &order=viewCount &q=skateboarding+dog &type=video &videoDefinition=high
Xem tài liệu của phương thức search.list cho các mã mẫu.
Danh sách phát
Ví dụ này cho thấy cách tìm danh sách phát khớp với cụm từ tìm kiếm "Googledeveloper". Phương thức này gọi phương thức search.list và đặt giá trị của thông số type thành playlist để kết quả được đặt chỉ bao gồm các danh sách phát.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=GoogleDevelopers &type=playlist
Kênh
Ví dụ này cho biết cách tìm các kênh khớp với cụm từ tìm kiếm "du lịch". Phương thức này gọi phương thức search.list và đặt giá trị của thông số type thành channel để kết quả được đặt chỉ bao gồm các kênh.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=travel &type=channel
Kết quả liên quan đến một ngôn ngữ cụ thể
Ví dụ này gọi phương thức search.list để tìm kết quả tìm kiếm phù hợp nhất với một ngôn ngữ cụ thể. Ví dụ này cho thấy cụm từ truy vấn là marine (q=marine) và nội dung phản hồi của API phải chứa kết quả phù hợp nhất với tiếng Pháp (relevanceLanguage=fr).
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=marine &relevanceLanguage=fr
Xin lưu ý rằng yêu cầu này không đặt giá trị cho tham số type, tức là mỗi kết quả tìm kiếm đều có thể tham chiếu đến một video, danh sách phát hoặc kênh.
Video được tải lên qua ứng dụng hoặc trang web của nhà phát triển
Ví dụ này cho thấy cách sử dụng tham số forDeveloper để hạn chế tìm kiếm chỉ truy xuất video được tải lên qua ứng dụng hoặc trang web của nhà phát triển. Tham số này có thể được dùng kết hợp với các tham số tìm kiếm không bắt buộc, chẳng hạn như tham số q.
Lưu ý: Truy vấn này không thực sự trả về kết quả trong APIs Explorer vì API Explorer không hỗ trợ tải video lên. Bạn có thể chạy truy vấn này cho ứng dụng của mình bên ngoài APIs Explorer, nhưng bạn không thể nhận kết quả cho ứng dụng của bạn bằng APIs Explorer.
Mỗi video đã tải lên sẽ tự động được gắn thẻ bằng số dự án được liên kết với ứng dụng của nhà phát triển trong Google API Console.
Sau đó, khi một yêu cầu tìm kiếm đặt tham số forDeveloper thành true, dịch vụ API sẽ sử dụng thông tin cấp phép của yêu cầu đó để xác định nhà phát triển. Theo đó, nhà phát triển có thể hạn chế kết quả đối với video tải lên thông qua ứng dụng hoặc trang web của nhà phát triển, nhưng không phải là kết quả của những video được tải lên thông qua ứng dụng hoặc trang web khác.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=fun &forDeveloper=true