> ## 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 de YouTube no aplicada (canal no verificado)

> Tu video de YouTube se publica correctamente pero falta la miniatura personalizada. La causa más común es un canal de YouTube no verificado.

Cuando publicas un video de YouTube con un `thumbNail` personalizado, el video puede publicarse correctamente aunque la miniatura no se aplique. En este caso, el `status` de nivel superior de la publicación sigue siendo `"success"` (el video está publicado), pero el resultado de YouTube lleva un arreglo `warnings` que describe el fallo de la 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>"
    }
  ]
}
```

## Síntoma

Tu video de YouTube aparece en el canal, pero la miniatura personalizada que proporcionaste no está — YouTube usa un frame autogenerado en su lugar. La respuesta de la API devuelve `status: "success"` con una entrada de miniatura en `warnings` (`feature: "thumbnail"`, `code: 307`).

## Causa más común: canal no verificado

La causa dominante de un fallo `403` de miniatura de YouTube es un **canal de YouTube no verificado**. YouTube requiere la verificación del canal (por teléfono) antes de aceptar la subida de una miniatura personalizada.

### Solución: verifica tu canal

1. Ve a [https://www.youtube.com/verify](https://www.youtube.com/verify) y completa la **verificación por teléfono** del canal.
2. Como alternativa, en [YouTube Studio](https://studio.youtube.com/) ve a *Settings → Channel*, selecciona *Feature Eligibility* y habilita *Features that require phone verification*.
3. YouTube puede tardar hasta 24 horas en habilitar las miniaturas personalizadas después de la verificación. La verificación de teléfono "habilitada" no garantiza que YouTube permita subir miniaturas — en última instancia, YouTube determina la elegibilidad.
4. Confirma que puedes subir manualmente una miniatura en YouTube Studio. Si no puedes hacerlo manualmente, la API tampoco podrá.

## Causa secundaria: permisos de OAuth

Si tu canal **ya está verificado** y las miniaturas siguen fallando con un `403`, es posible que a la cuenta de YouTube vinculada le falten los permisos requeridos. Intenta **desvincular y volver a vincular** tu cuenta de YouTube en [Social Accounts](https://app.ayrshare.com/social-accounts) y otorga todos los permisos solicitados durante la revinculación.

Para las cuentas Brand/Content Owner (usadas a menudo para canales de empresas u organizaciones), asegúrate de que la cuenta vinculada tenga los permisos necesarios — recomendamos derechos de "Owner".

## Requisitos previos a la publicación de la miniatura

Ayrshare valida el `thumbNail` antes de publicar cuando es posible. Para evitar un fallo `307` en la miniatura, asegúrate de que la miniatura cumpla estos requisitos:

<ul class="custom-bullets">
  <li>**Formato:** PNG o JPG/JPEG. La extensión del archivo debe terminar en <code>png</code>, <code>jpg</code> o <code>jpeg</code>.</li>
  <li>**Tamaño:** 2 MB o menos.</li>
  <li>**URL alcanzable:** la URL de <code>thumbNail</code> debe ser accesible públicamente para que Ayrshare pueda obtenerla.</li>
</ul>

Un problema de miniatura nunca hace fallar la publicación. Si una miniatura es definitivamente inválida (extensión incorrecta, más de 2 MB confirmado o inalcanzable), Ayrshare la omite antes de subir el video, publica el video de todos modos y reporta el motivo en `warnings`. Si el fallo solo puede determinarse después de subir el video, el video permanece publicado y el fallo se expone mediante el mismo arreglo `warnings` descrito arriba. En cualquier caso, el video se publica y `status` sigue siendo `"success"`.

## Relacionado

* [API de publicación en YouTube — Miniaturas](/apis/post/social-networks/youtube#youtube-thumbnails)
* [Directrices de medios de YouTube](/media-guidelines/youtube#thumbnails)
* [Códigos de error — Código 307](/errors/errors-ayrshare#youtube-thumbnail-errors-code-307)