Search

Um resultado da pesquisa contém informações sobre um vídeo, canal ou playlist do YouTube que correspondem aos parâmetros de pesquisa especificados em uma solicitação de API. Embora um resultado da pesquisa aponte para um recurso exclusivamente identificável, como um vídeo, ele não tem os próprios dados persistentes.

Métodos

A API suporta os seguintes métodos de pesquisa:

list
Retorna um conjunto de resultados da pesquisa que correspondem aos parâmetros de consulta especificados na solicitação de API. Por padrão, um conjunto de resultados da pesquisa identifica os recursos correspondentes de video, channel e playlist, mas também é possível configurar consultas para recuperar apenas um tipo específico de recurso. Teste agora mesmo.

Representação de recurso

A estrutura JSON a seguir mostra o formato de um resultado de pesquisa:

{
  "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
  }
}

Propriedades

A tabela a seguir define as propriedades que aparecem no resultado da busca:

Propriedades
kind string
Identifica o tipo de recurso da API. O valor será youtube#searchResult.
etag etag
A Etag desse recurso.
id object
O objeto id contém informações que podem ser usadas para identificar de forma exclusiva o recurso que corresponde à solicitação de pesquisa.
id.kind string
O tipo de recurso da API.
id.videoId string
Se o valor da propriedade id.type for youtube#video, essa propriedade estará presente, e o valor dela conterá o ID que o YouTube usa para identificar de forma exclusiva um vídeo que corresponda à consulta de pesquisa.
id.channelId string
Se o valor da propriedade id.type for youtube#channel, essa propriedade estará presente, e o valor dela conterá o ID que o YouTube usa para identificar de forma exclusiva um canal que corresponda à consulta de pesquisa.
id.playlistId string
Se o valor da propriedade id.type for youtube#playlist, essa propriedade vai estar presente, e o valor vai conter o ID que o YouTube usa para identificar de forma exclusiva uma playlist que corresponda à consulta de pesquisa.
snippet object
O objeto snippet contém detalhes básicos sobre um resultado da pesquisa, como o título ou a descrição. Por exemplo, se o resultado da pesquisa for um vídeo, o título será o título do vídeo e a descrição será a descrição do vídeo.
snippet.publishedAt datetime
A data e a hora de criação do recurso identificado pelo resultado da pesquisa. O valor é especificado no formato ISO 8601.
snippet.channelId string
O valor que o YouTube usa para identificar de forma exclusiva o canal que publicou o recurso identificado pelo resultado da pesquisa.
snippet.title string
O título do resultado da pesquisa.
snippet.description string
Uma descrição do resultado da pesquisa.
snippet.thumbnails object
Um mapa de imagens em miniatura associadas ao resultado da pesquisa. Para cada objeto no mapa, a chave é o nome da imagem em miniatura, e o valor é um objeto que contém outras informações sobre a miniatura.
snippet.thumbnails.(key) object
As chaves-valor válidas são:
  • default – A imagem em miniatura padrão. A miniatura padrão para um vídeo ou um recurso que se refere a um vídeo, como um item da playlist ou o resultado da pesquisa, tem 120 px de largura e 90px de altura. A miniatura padrão de um canal tem 88 px de largura e 88 px de altura.
  • medium: uma versão de resolução mais alta da imagem em miniatura. Para um vídeo (ou um recurso que se refira a um vídeo), esta imagem tem 320 px de largura e 180 px de altura. Para um canal, esta imagem tem 240 px de largura e 240 px de altura.
  • high – Uma versão de alta resolução da imagem em miniatura. Para um vídeo (ou um recurso que se refira a um vídeo), esta imagem tem 480 px de largura e 360 px de altura. Para um canal, esta imagem tem 800 px de largura e 800 px de altura.
  • standard: uma versão com resolução ainda maior da imagem em miniatura do que a imagem com resolução high. Essa imagem está disponível para alguns vídeos e outros recursos relacionados a vídeos, como itens de playlist ou resultados de pesquisa. Esta imagem tem 640 px de largura e 480 px de altura.
  • maxres – A versão de resolução mais alta da imagem em miniatura. Esse tamanho de imagem está disponível para alguns vídeos e outros recursos relacionados a vídeos, como itens de playlist ou resultados de pesquisa. Esta imagem tem 1.280 px de largura e 720 px de altura.
snippet.thumbnails.(key).url string
O URL da imagem.
snippet.thumbnails.(key).width unsigned integer
A largura da imagem.
snippet.thumbnails.(key).height unsigned integer
A altura da imagem.
snippet.channelTitle string
O título do canal que publicou o recurso identificado pelo resultado da pesquisa.
snippet.liveBroadcastContent string
Uma indicação se um recurso video ou channel tem conteúdo de transmissão ao vivo. Os valores de propriedade válidos são upcoming, live e none.

Para um recurso video, o valor upcoming indica que o vídeo é uma transmissão ao vivo que ainda não foi iniciada, enquanto o valor live indica que o vídeo é uma transmissão ao vivo ativa. Para um recurso channel, o valor upcoming indica que o canal tem uma transmissão programada que ainda não foi iniciada, enquanto o valor live indica que o canal tem uma transmissão ao vivo ativa.