Passer au contenu principal
Lorsque vous publiez une vidéo YouTube avec un thumbNail personnalisé, la vidéo peut être publiée avec succès tandis que la miniature échoue à s’appliquer. Dans ce cas, le status de niveau supérieur de la publication reste "success" (la vidéo est en ligne), mais le résultat YouTube contient un tableau warnings décrivant l’échec de la miniature :

​
Symptôme

Votre vidéo YouTube apparaît sur la chaîne, mais la miniature personnalisée que vous avez fournie est absente — YouTube utilise à la place une image générée automatiquement. La réponse de l’API renvoie status: "success" avec une entrée warnings de miniature (feature: "thumbnail", code: 307).

​
Cause la plus fréquente : chaîne non vérifiée

La cause principale d’un échec 403 de miniature YouTube est une chaîne YouTube non vérifiée. YouTube exige la vérification de la chaîne (par téléphone) avant d’accepter le téléchargement d’une miniature personnalisée.

​
Correction : vérifiez votre chaîne

  1. Allez sur https://www.youtube.com/verify et effectuez la vérification par téléphone pour la chaîne.
  2. Alternativement, dans YouTube Studio, allez dans Paramètres → Chaîne, sélectionnez Éligibilité aux fonctionnalités et activez Fonctionnalités nécessitant une vérification par téléphone.
  3. YouTube peut prendre jusqu’à 24 heures pour activer les miniatures personnalisées après vérification. Une vérification par téléphone « activée » ne garantit pas que YouTube autorisera les téléchargements de miniatures — YouTube détermine en dernier ressort l’éligibilité.
  4. Confirmez que vous pouvez télécharger manuellement une miniature dans YouTube Studio. Si vous ne pouvez pas le faire manuellement, l’API ne le peut pas non plus.

​
Cause secondaire : autorisations OAuth

Si votre chaîne est déjà vérifiée et que les miniatures échouent toujours avec un 403, il se peut que le compte YouTube lié ne dispose pas des autorisations requises. Essayez de délier et relier votre compte YouTube dans Comptes sociaux et accordez toutes les autorisations demandées lors de la relaison. Pour les comptes de marque / propriétaire de contenu (souvent utilisés pour les chaînes professionnelles ou d’organisation), assurez-vous que le compte lié dispose des autorisations nécessaires — nous recommandons les droits de « Propriétaire ».

​
Exigences relatives à la miniature avant publication

Ayrshare valide le thumbNail avant la publication lorsque cela est possible. Pour éviter un échec de miniature 307, assurez-vous que la miniature répond aux exigences suivantes :
  • Format : PNG ou JPG/JPEG. L’extension du fichier doit se terminer par png, jpg ou jpeg.
  • Taille : 2 Mo ou moins.
  • URL accessible : l’URL thumbNail doit être accessible publiquement afin qu’Ayrshare puisse la récupérer.
Un problème de miniature ne fait jamais échouer la publication. Si une miniature est définitivement invalide (mauvaise extension, taille confirmée supérieure à 2 Mo ou inaccessible), Ayrshare l’ignore avant le téléchargement de la vidéo, publie toujours la vidéo et signale la raison dans warnings. Si l’échec ne peut être déterminé qu’après le téléchargement de la vidéo, la vidéo reste en ligne et l’échec est signalé via le même tableau warnings décrit ci-dessus. Dans les deux cas, la vidéo est publiée et status reste "success".

​
Voir aussi