Thumbnails

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

  • A propriedade snippet.thumbnails de um 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.) se refere 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 video normalmente tem 120 x 90 pixels, e a default para um recurso channel normalmente tem 88 x 88 pixels.
  • 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 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 oferece suporte aos seguintes métodos para recursos thumbnails:

definir
Faz upload de uma miniatura personalizada no YouTube e a define para um vídeo.

Representação de recurso

A estrutura JSON a seguir 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
  },
  "standard": {
    "url": string,
    "width": unsigned integer,
    "height": unsigned integer
  },
  "maxres": {
    "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 90px 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 em 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.
standard object
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.
standard.url string
O URL da imagem.
standard.width unsigned integer
A largura da imagem.
standard.height unsigned integer
A altura da imagem.
maxres object
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.
maxres.url string
O URL da imagem.
maxres.width unsigned integer
A largura da imagem.
maxres.height unsigned integer
A altura da imagem.