Corrija miniaturas (thumbnails) de vídeo em aplicações customizadas

Se você usa a API do Vimeo nas suas aplicações customizadas e/ou está armazenando em cache o URL da miniatura de foto (thumbnail) do seu vídeo, suas miniaturas talvez tenham desaparecido do player de vídeo, principalmente se os URLs das miniaturas foram codificadas em uma aplicação ou site, o que significa que a estrutura do link não é atualizada automaticamente.

Para corrigir as miniaturas nesses casos de uso, você precisa iniciar uma chamada de API para obter (GET) a miniatura do vídeo dos servidores do Vimeo. Recomendamos fazer isso regularmente em vez de armazenar em cache o URL das miniaturas dos vídeos. Também recomendamos, se possível, agrupar essas chamadas em lotes para fins de eficiência. 

Você pode encontrar documentação adicional sobre como recuperar seus URLs em miniatura por meio da API do Vimeo em nosso site de desenvolvimento Desenvolvedor do Vimeo: Obtenha uma miniatura de vídeo específica.

Confira abaixo um guia passo a passo sobre como obter as URLs das miniaturas dos seus vídeos:

1. 1. Entre na sua conta do Vimeo e acesse https://developer.vimeo.com/  
   2. Se você ainda não tem um aplicativo, clique em Novo aplicativo.
      • Dê um nome e uma descrição ao aplicativo
      • Escolha Não
      • Selecione Criar aplicativo.
   3. Na página de configurações do aplicativo, crie um token de acesso para autenticar as chamadas para a API.
      • Em Autenticação > Geral, selecione Autenticado
      • Em Escopos, selecione Privado.
      • Clique em Gerar.
      • Copie o token gerado e salve-o em um editor de texto. Você precisará dele depois.
   4. Em uma aplicação de cliente de API (p. ex., Postman), faça uma solicitação de “GET” (Obter) e informe o URL abaixo:
      1. https://api.vimeo.com/me/videos
      2. Certifique-se de que o token esteja incluído no cabeçalho da sua solicitação GET (https://developer.vimeo.com/api/authentication), pois é necessário para fazer a autenticação. Se estiver usando o Postman, acesse a aba Autorização, selecione “Token do portador” no menu suspenso “Tipo“ e cole o token no campo de texto do token.
      3. Envie a solicitação.
   5. A carga útil incluirá muitas informações sobre seus vídeos. Você pode usar parâmetros adicionais listados em Desenvolvedor do Vimeo: Obtenha todas as miniaturas de um vídeo para especificar os resultados de que você precisa.
      • Por exemplo: https://api.vimeo.com/me/videos?fields=uri,name,pictures&per_page=100&page=1
        • Isso incluirá o ID do vídeo, o título do vídeo, o URL da miniatura e incluirá os primeiros 100 vídeos. 
        • O URL da miniatura de foto estará em “fotos” em cada vídeo.

Assista a um passo a passo do processo neste tutorial em vídeo: Recuperando URLs em miniatura de vídeo usando a API do Vimeo.