> ## 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.

# Miniature YouTube non appliquée (chaîne non vérifiée)

> Votre vidéo YouTube est publiée avec succès mais la miniature personnalisée est absente. La cause la plus fréquente est une chaîne YouTube non vérifiée.

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 :

```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>"
    }
  ]
}
```

## 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](https://www.youtube.com/verify) et effectuez la **vérification par téléphone** pour la chaîne.
2. Alternativement, dans [YouTube Studio](https://studio.youtube.com/), 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](https://app.ayrshare.com/social-accounts) 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 :

<ul class="custom-bullets">
  <li>**Format :** PNG ou JPG/JPEG. L'extension du fichier doit se terminer par <code>png</code>, <code>jpg</code> ou <code>jpeg</code>.</li>
  <li>**Taille :** 2 Mo ou moins.</li>
  <li>**URL accessible :** l'URL <code>thumbNail</code> doit être accessible publiquement afin qu'Ayrshare puisse la récupérer.</li>
</ul>

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

* [API de publication YouTube — Miniatures](/apis/post/social-networks/youtube#youtube-thumbnails)
* [Directives média YouTube](/media-guidelines/youtube#thumbnails)
* [Codes d'erreur — Code 307](/errors/errors-ayrshare#youtube-thumbnail-errors-code-307)