Te przykłady pokazują, jak wypełniać różne rodzaje żądań wyszukiwania w interfejsie API w wersji 3.
Filmy
W tym przykładzie metoda search.list służy do znajdowania najczęściej oglądanych filmów w wysokiej rozdzielczości (HD) powiązanych z zapytaniem „skateboarding dog” (ang. „pies na deskorolce”). 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
W tym przykładzie pokazujemy, jak znaleźć kanały pasujące do zapytania „podróże”. 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 dotyczące konkretnego języka,
W tym przykładzie wywołujemy metodę search.list, aby znaleźć wyniki wyszukiwania, które są najbardziej trafne dla konkretnego języka. Przykład pokazuje, że zapytanie to marine (q=marine), a odpowiedź interfejsu API powinna zawierać wyniki najbardziej trafne dla języka francuskiego (relevanceLanguage=fr).
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=marine &relevanceLanguage=fr
Pamiętaj, że żądanie nie ustawia 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 za pomocą parametru forDeveloper 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. Możesz wykonać to zapytanie w przypadku własnej aplikacji poza narzędziem APIs Explorer, ale nie możesz uzyskać wyników dla swojej aplikacji za pomocą tego narzędzia.
Każde przesłane wideo jest automatycznie otagowane numerem projektu powiązanym z aplikacją dewelopera w Konsoli interfejsów API Google.
Gdy żądanie wyszukiwania ustawia parametr forDeveloper na wartość „true” (prawda), usługa interfejsu API używa danych logowania z żądania do zidentyfikowania dewelopera. Dzięki temu deweloper może ograniczyć wyniki do filmów przesłanych za pomocą jego 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