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 devuelvestatus: "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 fallo403 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
- Ve a https://www.youtube.com/verify y completa la verificación por teléfono del canal.
- Como alternativa, en YouTube Studio ve a Settings → Channel, selecciona Feature Eligibility y habilita Features that require phone verification.
- 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.
- 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 un403, 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 elthumbNail 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,jpgojpeg. - Tamaño: 2 MB o menos.
- URL alcanzable: la URL de
thumbNaildebe ser accesible públicamente para que Ayrshare pueda obtenerla.
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".
