Search

search wynik zawiera informacje o filmie na YouTube, kanale lub playliście, które pasują do parametrów wyszukiwania określonych w żądaniu do interfejsu API. Wynik wyszukiwania wskazuje na jednoznacznie identyfikowalny zasób, np. film, ale nie ma własnych trwałych danych.

Metody

Interfejs API obsługuje te metody wyszukiwania:

list

Zwraca kolekcję wyników wyszukiwania pasujących do parametrów zapytania określonych w żądaniu do interfejsu API. Domyślnie zestaw wyników wyszukiwania identyfikuje pasujące zasoby video, channel i playlist, ale możesz też skonfigurować zapytania tak, aby pobierały tylko określony typ zasobu. Wypróbuj teraz

Prezentacja zasobów

Poniższa struktura JSON przedstawia format wyniku wyszukiwania:

{
  "kind": "youtube#searchResult",
  "etag": etag,
  "id": {
    "kind": string,
    "videoId": string,
    "channelId": string,
    "playlistId": string
  },
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "liveBroadcastContent": string
  }
}

Właściwości

W tabeli poniżej znajdziesz definicje właściwości, które pojawiają się w wynikach wyszukiwania:

Właściwości
kind	string Określa typ zasobu interfejsu API. Wartość będzie wynosić youtube#searchResult.
etag	etag Etag tego zasobu.
id	object Obiekt id zawiera informacje, które można wykorzystać do jednoznacznego zidentyfikowania zasobu pasującego do żądania wyszukiwania.
id.kind	string Typ zasobu interfejsu API.
id.videoId	string Jeśli wartość właściwości id.type to youtube#video, ta właściwość będzie obecna, a jej wartość będzie zawierać identyfikator, którego YouTube używa do jednoznacznego identyfikowania filmu pasującego do zapytania.
id.channelId	string Jeśli wartość właściwości id.type to youtube#channel, ta właściwość będzie obecna, a jej wartość będzie zawierać identyfikator, którego YouTube używa do jednoznacznego identyfikowania kanału pasującego do zapytania.
id.playlistId	string Jeśli wartość właściwości id.type to youtube#playlist, ta właściwość będzie obecna, a jej wartość będzie zawierać identyfikator, którego YouTube używa do jednoznacznego identyfikowania playlisty pasującej do zapytania.
snippet	object Obiekt snippet zawiera podstawowe informacje o wyniku wyszukiwania, takie jak tytuł lub opis. Jeśli na przykład wynikiem wyszukiwania jest film, tytułem będzie tytuł filmu, a opisem – opis filmu.
snippet.publishedAt	datetime Data i godzina utworzenia zasobu, który identyfikuje wynik wyszukiwania. Wartość jest podana w formacie ISO 8601.
snippet.channelId	string Wartość, której YouTube używa do jednoznacznego identyfikowania kanału, który opublikował zasób identyfikowany przez wynik wyszukiwania.
snippet.title	string Tytuł wyniku wyszukiwania.
snippet.description	string Opis wyniku wyszukiwania.
snippet.thumbnails	object Mapa miniatur powiązanych z wynikiem wyszukiwania. W przypadku każdego obiektu na mapie kluczem jest nazwa miniatury, a wartością jest obiekt zawierający inne informacje o miniaturze.
snippet.thumbnails.(key)	object Prawidłowe wartości klucza to: default – domyślna miniatura. Domyślna miniatura filmu lub zasobu, który odnosi się do filmu, np. elementu playlisty lub wyniku wyszukiwania, ma szerokość 120 pikseli i wysokość 90 pikseli. Domyślna miniatura kanału ma 88 pikseli szerokości i 88 pikseli wysokości. medium – wersja miniatury w wyższej rozdzielczości. W przypadku filmu (lub zasobu, który odwołuje się do filmu) obraz ma szerokość 320 pikseli i wysokość 180 pikseli. W przypadku kanału obraz ten ma szerokość 240 pikseli i wysokość 240 pikseli. high – wersja miniatury w wysokiej rozdzielczości. W przypadku filmu (lub zasobu, który odwołuje się do filmu) ten obraz ma szerokość 480 pikseli i wysokość 360 pikseli. W przypadku kanału obraz ten ma szerokość i wysokość 800 pikseli. standard – wersja miniatury o jeszcze wyższej rozdzielczości niż obraz o rozdzielczości high. Ten obraz jest dostępny w przypadku niektórych filmów i innych zasobów, które się do nich odnoszą, np. elementów playlisty czy wyników wyszukiwania. Ten obraz ma szerokość 640 pikseli i wysokość 480 pikseli. maxres – wersja miniatury w najwyższej rozdzielczości. Ten rozmiar obrazu jest dostępny w przypadku niektórych filmów i innych zasobów, które odwołują się do filmów, takich jak elementy playlisty czy wyniki wyszukiwania. Ten obraz ma szerokość 1280 pikseli i wysokość 720 pikseli. Uwaga: miniatury w rozdzielczości 1080p+ (fhd, qhd i uhd) nie są obsługiwane w wynikach wyszukiwania. Aby pobrać miniatury w wyższej rozdzielczości, wywołaj punkt końcowy konkretnego zasobu (np. videos.list) za pomocą identyfikatora zasobu.
snippet.thumbnails.(key).url	string Adres URL obrazu.
snippet.thumbnails.(key).width	unsigned integer Szerokość obrazu.
snippet.thumbnails.(key).height	unsigned integer Wysokość obrazu.
snippet.channelTitle	string Tytuł kanału, który opublikował zasób zidentyfikowany w wyniku wyszukiwania.
snippet.liveBroadcastContent	string Wskazuje, czy zasób video lub channel zawiera treści transmitowane na żywo. Prawidłowe wartości właściwości to upcoming, live i none. W przypadku zasobu video wartość upcoming oznacza, że film jest transmisją na żywo, która jeszcze się nie rozpoczęła, a wartość live oznacza, że film jest aktywną transmisją na żywo. W przypadku zasobu channel wartość upcoming oznacza, że kanał ma zaplanowaną transmisję, która jeszcze się nie rozpoczęła, a wartość live oznacza, że kanał ma aktywną transmisję na żywo.