Z przykładów poniżej dowiesz się, jak wykonywać różne rodzaje żądań wyszukiwania w interfejsie API w wersji 3.
Filmy
W tym przykładzie wywołujemy metodę search.list, aby znaleźć najczęściej oglądane filmy w wysokiej rozdzielczości (HD) powiązane z zapytaniem „skateboarding dog”. Zapytanie ustawia parametry order, part, q, type i videoDefinition.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &order=viewCount &q=skateboarding+dog &type=video &videoDefinition=high
Przykłady kodu znajdziesz w dokumentacji metody search.list.
Playlisty
Ten przykład pokazuje, jak znaleźć playlisty pasujące do zapytania „GoogleDevelopers”. Wywołuje metodę search.list i ustawia wartość parametru type na playlist, aby zestaw wyników zawierał tylko playlisty.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=GoogleDevelopers &type=playlist
Kanały
Ten przykład pokazuje, jak znaleźć kanały pasujące do zapytania „travel”. Wywołuje metodę search.list i ustawia wartość parametru type na channel, aby zestaw wyników zawierał tylko kanały.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=travel &type=channel
Wyniki powiązane z określonym językiem
W tym przykładzie wywołujemy metodę search.list, aby znaleźć wyniki wyszukiwania, które są najbardziej powiązane z określonym językiem. Przykład pokazuje, że zapytanie to marine (q=marine), a odpowiedź interfejsu API powinna zawierać wyniki najbardziej powiązane z językiem francuskim (relevanceLanguage=fr).
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=marine &relevanceLanguage=fr
Pamiętaj, że w żądaniu nie ustawiono wartości parametru type, co oznacza, że każdy wynik wyszukiwania może odnosić się do filmu, playlisty lub kanału.
Filmy przesłane za pomocą aplikacji lub witryny dewelopera
Ten przykład pokazuje, jak użyć parametru forDeveloper, aby ograniczyć wyszukiwanie do filmów przesłanych za pomocą aplikacji lub witryny dewelopera. Tego parametru można używać w połączeniu z opcjonalnymi parametrami wyszukiwania, takimi jak parametr q.
Uwaga: to zapytanie nie zwraca wyników w narzędziu APIs Explorer, ponieważ nie obsługuje ono przesyłania filmów. To zapytanie możesz uruchomić w swojej aplikacji poza narzędziem APIs Explorer, ale nie możesz uzyskać wyników dla swojej aplikacji za pomocą tego narzędzia.
Każdy przesłany film jest automatycznie oznaczany numerem projektu powiązanym z aplikacją dewelopera w konsoli Google Cloud.
Gdy żądanie wyszukiwania ustawi parametr forDeveloper na true, usługa interfejsu API użyje danych uwierzytelniających żądania, aby zidentyfikować dewelopera. Dzięki temu deweloper może ograniczyć wyniki do filmów przesłanych za pomocą własnej aplikacji lub witryny, ale nie do filmów przesłanych za pomocą innych aplikacji lub witryn.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=fun &forDeveloper=true