Saltar al contenido principal
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:

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 y completa la verificación por teléfono del canal.
  2. Como alternativa, en YouTube Studio 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 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:
  • Formato: PNG o JPG/JPEG. La extensión del archivo debe terminar en png, jpg o jpeg.
  • Tamaño: 2 MB o menos.
  • URL alcanzable: la URL de thumbNail debe ser accesible públicamente para que Ayrshare pueda obtenerla.
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