Miniatura do YouTube não aplicada (canal não verificado)

Ao publicar um vídeo do YouTube com um thumbNail personalizado, o vídeo pode ser publicado com sucesso enquanto a miniatura não é aplicada. Nesse caso, o status de nível superior da publicação permanece "success" (o vídeo está no ar), mas o resultado do YouTube traz um array warnings descrevendo a falha da miniatura:

{
  "status": "success",
  "id": "<videoId>",
  "thumbnail": {
    "action": "post",
    "status": "error",
    "code": 307,
    "message": "Your YouTube channel must be verified to set a custom thumbnail. Verify your channel at https://www.youtube.com/verify (phone verification). If your channel is already verified, try unlinking and re-linking your YouTube account to restore permissions.",
    "details": "<upstream message>"
  },
  "warnings": [
    {
      "feature": "thumbnail",
      "code": 307,
      "message": "Your YouTube channel must be verified to set a custom thumbnail. Verify your channel at https://www.youtube.com/verify (phone verification). If your channel is already verified, try unlinking and re-linking your YouTube account to restore permissions.",
      "details": "<upstream message>"
    }
  ]
}

Sintoma

Seu vídeo do YouTube aparece no canal, mas a miniatura personalizada que você forneceu está ausente — o YouTube usa um quadro gerado automaticamente em vez dela. A resposta da API retorna status: "success" com uma entrada de warnings de miniatura (feature: "thumbnail", code: 307).

Causa mais comum: canal não verificado

A causa dominante de uma falha 403 na miniatura do YouTube é um canal do YouTube não verificado. O YouTube exige a verificação (por telefone) do canal antes de aceitar o upload de uma miniatura personalizada.

Correção: verifique seu canal

Acesse https://www.youtube.com/verify e conclua a verificação por telefone do canal.
Como alternativa, no YouTube Studio, vá em Settings → Channel, selecione Feature Eligibility e habilite Features that require phone verification.
O YouTube pode levar até 24 horas para habilitar miniaturas personalizadas após a verificação. A verificação por telefone “habilitada” não garante que o YouTube permitirá uploads de miniatura — em última análise, o YouTube determina a elegibilidade.
Confirme se você consegue fazer o upload manual de uma miniatura no YouTube Studio. Se não conseguir fazer manualmente, a API também não conseguirá.

Causa secundária: permissões OAuth

Se seu canal já está verificado e as miniaturas ainda falham com 403, a conta do YouTube vinculada pode estar sem as permissões necessárias. Tente desvincular e revincular sua conta do YouTube em Social Accounts e concede todas as permissões solicitadas durante a reconexão. Para contas Brand / Content Owner (frequentemente usadas para canais de negócios ou organizações), certifique-se de que a conta vinculada tenha as permissões necessárias — recomendamos direitos de “Owner”.

Requisitos de miniatura antes da publicação

O Ayrshare valida a thumbNail antes de publicar, quando possível. Para evitar uma falha de miniatura 307, garanta que a miniatura atenda a estes requisitos:

Formato: PNG ou JPG/JPEG. A extensão do arquivo deve terminar em png, jpg ou jpeg.
Tamanho: 2MB ou menos.
URL acessível: A URL do thumbNail deve ser publicamente acessível para que o Ayrshare possa buscá-la.

Um problema de miniatura nunca faz a publicação falhar. Se uma miniatura for definitivamente inválida (extensão incorreta, comprovadamente acima de 2MB ou inacessível), o Ayrshare a ignora antes do upload do vídeo, publica o vídeo mesmo assim e informa o motivo em warnings. Se a falha só puder ser determinada após o upload do vídeo, o vídeo permanece no ar e a falha é comunicada pelo mesmo array warnings descrito acima. De qualquer forma, o vídeo é publicado e o status permanece "success".

​Sintoma

​Causa mais comum: canal não verificado

​Correção: verifique seu canal

​Causa secundária: permissões OAuth

​Requisitos de miniatura antes da publicação

​Relacionado

Sintoma

Causa mais comum: canal não verificado

Correção: verifique seu canal

Causa secundária: permissões OAuth

Requisitos de miniatura antes da publicação

Relacionado