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 phiên bản 3.
Video
Ví dụ này gọi phương thức search.list để tìm những video có độ phân giải cao (HD) được xem nhiều nhất liên quan đến cụm từ tìm kiếm "chó trượt ván". Truy vấn này đặt các tham 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 về phương thức search.list để biết mã mẫu.
Danh sách phát
Ví dụ này cho thấy cách tìm các danh sách phát khớp với cụm từ tìm kiếm "GoogleDevelopers". Phương thức này gọi phương thức search.list và đặt giá trị của tham số type thành playlist để tập hợp kết quả chỉ bao gồm 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 thấy cách tìm những kênh khớp với cụm từ tìm kiếm "du lịch". Hàm này gọi phương thức search.list và đặt giá trị của tham số type thành channel để tập hợp kết quả 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ả có 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ừ tìm kiếm là marine (q=marine) và phản hồi API phải chứa kết quả phù hợp nhất với ngôn ngữ 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 thông số type, tức là mỗi kết quả tìm kiếm 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ế một lượt tìm kiếm chỉ truy xuất những video được tải lên thông qua ứng dụng hoặc trang web của nhà phát triển. Bạn có thể sử dụng tham số này cùng 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 thực sự không trả về kết quả trong Trình khám phá API vì Trình khám phá API 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 riêng mình bên ngoài Trình khám phá API, nhưng không thể nhận kết quả cho ứng dụng của bạn bằng Trình khám phá API.
Mỗi video được tải lên sẽ tự động được gắn thẻ bằng số dự án liên kết với ứng dụng của nhà phát triển trong Bảng điều khiển API của Google.
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 xác thực uỷ quyền của yêu cầu đó để xác định nhà phát triển. Do đó, nhà phát triển có thể chỉ cho phép kết quả tìm kiếm là những video được tải lên thông qua ứng dụng hoặc trang web của chính nhà phát triển, chứ không phải những video được tải lên thông qua các ứ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