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 khác nhau 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) và có nhiều lượt xem 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
Hãy xem tài liệu về phương thức search.list để biết 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 "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 các kênh khớp với cụm từ tìm kiếm "du lịch". Thao tác này gọi phương thức search.list và đặt giá trị của tham số type thành channel để tậ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ả 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 của API phải chứa các 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 có thể tham chiếu đến một video, danh sách phát hoặc kênh.
Video được tải lên thông 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 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 không thực sự trả về kết quả trong APIs Explorer vì APIs 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 riêng 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 mình bằng APIs Explorer.
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 Google Cloud 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 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ể giới hạn kết quả chỉ bao gồm 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 bao gồm 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