> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Seu vídeo do YouTube é publicado com sucesso, mas a miniatura personalizada está ausente. A causa mais comum é um canal do YouTube 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:

```json theme={"system"}
{
  "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

1. Acesse [https://www.youtube.com/verify](https://www.youtube.com/verify) e conclua a **verificação por telefone** do canal.
2. Como alternativa, no [YouTube Studio](https://studio.youtube.com/), vá em *Settings → Channel*, selecione *Feature Eligibility* e habilite *Features that require phone verification*.
3. 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.
4. 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](https://app.ayrshare.com/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:

<ul class="custom-bullets">
  <li>**Formato:** PNG ou JPG/JPEG. A extensão do arquivo deve terminar em <code>png</code>, <code>jpg</code> ou <code>jpeg</code>.</li>
  <li>**Tamanho:** 2MB ou menos.</li>
  <li>**URL acessível:** A URL do <code>thumbNail</code> deve ser publicamente acessível para que o Ayrshare possa buscá-la.</li>
</ul>

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"`.

## Relacionado

* [YouTube Post API — Miniaturas](/apis/post/social-networks/youtube#youtube-thumbnails)
* [Diretrizes de mídia do YouTube](/media-guidelines/youtube#thumbnails)
* [Códigos de erro — Code 307](/errors/errors-ayrshare#youtube-thumbnail-errors-code-307)