Thumbnails

Um recurso thumbnail identifica diferentes tamanhos de imagens em miniatura associadas a um recurso. Observe as seguintes características das imagens em miniatura:

  • Uma propriedade snippet.thumbnails do recurso é um objeto que identifica as imagens em miniatura disponíveis para esse recurso.
  • Um recurso thumbnail contém uma série de objetos. O nome de cada objeto (default, medium, high, etc.) refere-se ao tamanho da imagem em miniatura.
  • Diferentes tipos de recursos podem suportar diferentes tamanhos de imagens em miniatura.
  • Diferentes tipos de recursos podem definir tamanhos diferentes para imagens em miniatura com o mesmo nome. Por exemplo, a imagem em miniatura default de um recurso de video normalmente é 120px por 90px, e a imagem em miniatura default para um recurso de channel normalmente é 88px por 88px.
  • Recursos do mesmo tipo ainda podem ter diferentes tamanhos de imagem em miniatura para determinadas imagens, dependendo da resolução da imagem original ou do conteúdo carregado no YouTube. Por exemplo, um vídeo em HD pode apoiar miniaturas de resolução maior que vídeos não HD.
  • Cada objeto que contém informações sobre um tamanho de imagem em miniatura tem uma propriedade width e uma propriedade height. No entanto, as propriedades de largura e altura podem não ser retornadas para essa imagem.
  • Se uma imagem em miniatura carregada não corresponder às dimensões necessárias, a imagem será redimensionada para corresponder ao tamanho correto, sem alteração de sua proporção. A imagem não é cortada, mas pode incluir barras pretas para que o tamanho fique correto.

Métodos

A API suporta os seguintes métodos para recursos thumbnails:

set
Carrega uma miniatura de vídeo personalizada para o YouTube e a define para um vídeo.

Representação de recurso

A estrutura JSON abaixo mostra o formato de um recurso thumbnails:

{
  "default": {
    "url": string,
    "width": unsigned integer,
    "height": unsigned integer
  },
  "medium": {
    "url": string,
    "width": unsigned integer,
    "height": unsigned integer
  },
  "high": {
    "url": string,
    "width": unsigned integer,
    "height": unsigned integer
  }
}

Propriedades

A tabela a seguir define as propriedades que aparecem neste recurso:

Propriedades
default object
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 90 px de altura. A miniatura padrão de um canal tem 88 px de largura e 88 px de altura.
default.url string
O URL da imagem.
default.width unsigned integer
A largura da imagem.
default.height unsigned integer
A altura da imagem.
medium object
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.
medium.url string
O URL da imagem.
medium.width unsigned integer
A largura da imagem.
medium.height unsigned integer
A altura da imagem.
high object
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.
high.url string
O URL da imagem.
high.width unsigned integer
A largura da imagem.
high.height unsigned integer
A altura da imagem.