Poniższe przykłady pokazują, jak wykonać kilka różnych typów żądań wyszukiwania w interfejsie API w wersji 3.
Filmy
Ten przykład wywołuje metodę search.list
, aby znaleźć najczęściej wyświetlane filmy w wysokiej rozdzielczości (HD), które są powiązane z zapytaniem o psa 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
.
w playlistach.
Ten przykład pokazuje, jak znaleźć playlisty pasujące do zapytania „GoogleDevelopers”. Wywołuje metodę search.list
i ustawia wartość parametru type
na playlist
, dzięki czemu 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 „podróże”. Wywołuje metodę search.list
i ustawia wartość parametru type
na channel
, dzięki czemu zestaw wyników uwzględnia 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ływana jest metoda search.list
, która znajduje wyniki wyszukiwania najbardziej odpowiednie dla konkretnego języka. W przykładzie widać, że wyszukiwane hasło to marine (q=marine
), a odpowiedź dotycząca interfejsu API powinna zawierać wyniki najbardziej trafne w przypadku 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 przez aplikację lub stronę internetową dewelopera
Ten przykład pokazuje, jak użyć parametru forDeveloper
, aby ograniczyć wyszukiwanie tylko do filmów przesłanych za pomocą aplikacji lub witryny dewelopera. Tego parametru można używać w połączeniu z opcjonalnymi parametrami wyszukiwania, np. q
.
Uwaga: to zapytanie w rzeczywistości nie zwraca wyników w eksploratorze interfejsów API, ponieważ interfejs API Explorer nie obsługuje przesyłania filmów. Możesz uruchomić to zapytanie dla swojej aplikacji poza Eksploratorem interfejsów API, ale nie możesz uzyskać wyników dla Twojej aplikacji za pomocą Eksploratora interfejsów API.
Każdy przesłany film jest automatycznie oznaczany numerem projektu powiązanym z aplikacją dewelopera w Konsoli interfejsów API Google.
Gdy w żądaniu wyszukiwania parametr forDeveloper
ma wartość Prawda, usługa interfejsu API identyfikuje dewelopera za pomocą danych uwierzytelniających żądania. W związku z tym deweloper może ograniczać wyniki do filmów przesłanych za pomocą aplikacji lub witryny, ale nie do filmów przesłanych przy użyciu innych aplikacji lub stron.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=fun &forDeveloper=true