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

# API YouTube

> Options de publication à l'aide de l'API YouTube

<Warning>
  La publication sur YouTube nécessite que votre compte YouTube dispose d'au moins un Channel et que vous en soyez propriétaire.
  Pour créer un YouTube Channel, cliquez sur votre profil dans le tableau de bord YouTube et choisissez « Create a Channel ».
  Vous pouvez également utiliser ce lien direct pour créer un YouTube Channel : [http://m.youtube.com/create\_channel](http://m.youtube.com/create_channel)

  Si vous rencontrez des problèmes pour voir vos YouTube channels, consultez le [guide de dépannage des YouTube channels](/help-center/technical-support/youtube_channels_not_showing).
</Warning>

<Info>
  Les échecs de téléversement YouTube peuvent renvoyer les codes d'erreur **453** (timeout) ou **454**
  (service indisponible) avec `retryAvailable: true`. Votre intégration peut se baser
  sur ce drapeau pour réessayer automatiquement les échecs transitoires avec backoff. Consultez la
  [référence des codes d'erreur](/errors/errors-ayrshare) pour la liste complète.
</Info>

Consultez [YouTube Media Guidelines](/media-guidelines/youtube) et [YouTube Authorization](/dashboard/connect-social-accounts/youtube) pour plus d'informations.

## Publier sur YouTube

### Vue d'ensemble de la publication

Publier via l'API YouTube nécessite l'objet `youTubeOptions` avec au minimum un paramètre `title` — 100 caractères maximum.
Le `title` est le seul champ requis et peut être auto-généré avec le [point de terminaison transcribe](/apis/generate/transcribe-video).

Par exemple, pour publier une vidéo YouTube avec les paramètres par défaut :

```json YouTube Post theme={"system"}
{
  // Required: Video description
  "post": "My Best YouTube Description", // empty string is allowed

  // Required: Platform to post to
  "platforms": ["youtube"],

  // Required: URL of video (only 1 allowed)
  "mediaUrls": ["https://img.ayrshare.com/012/vid.mp4"],

  "youTubeOptions": {
    // Required: Video title (max 100 characters)
    "title": "Your Best Title"
  }
}
```

Les vidéos YouTube sont `private` par défaut, mais la visibilité peut être définie sur `public` ou `unlisted`.
Consultez les champs facultatifs ci-dessous pour plus de détails.

### Champs facultatifs des publications YouTube

Il existe plusieurs autres champs facultatifs listés ci-dessous, notamment `visibility`, `tags` et la date `publishAt`. Consultez les commentaires pour connaître les exigences et descriptions.

```json YouTube Post Optional Fields theme={"system"}
{
  // Required fields
  "post": "My Best YouTube Description", // Video description, up to 5,000 characters
  "platforms": ["youtube"], // Platform to post to
  "mediaUrls": ["https://img.ayrshare.com/012/vid.mp4"], // URL of video (1 allowed)

  "youTubeOptions": {
    // Required fields
    "title": "Your Best Title", // Video Title (max 100 characters)

    /** Optional Fields **/

    // Visibility: "public", "unlisted", or "private" (default: "private")
    "visibility": "private",

    // Thumbnail settings - JPEG/PNG URL under 2MB, must end in png/jpg/jpeg
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg",

    // Video organization
    "playListId": "PLrav6EfwgDX5", // Playlist ID to add the video
    "tags": ["dancing", "dogs"], // Tag array (400 chars total, 2+ chars each)

    // Video settings
    "madeForKids": false, // Self-declared kids content (default: false)
    "license": "youtube", // "youtube" (default) or "creativeCommon"
    "embeddable": true, // default: true
    "publicStatsViewable": true, // default: true
    "shorts": true, // Post as YouTube Short (max 3 minutes, adds #shorts)
    "notifySubscribers": true, // Send notification to subscribers (default: true)
    "categoryId": 24, // Video category (24 = Entertainment)
    "containsSyntheticMedia": true, // Disclose that a video contains realistic Altered or Synthetic (A/S) content

    // YouTube controlled publishing - UTC publish time. See below for details.
    "publishAt": "2022-10-08T21:18:36Z",
  }
}
```

<ul class="custom-bullets">
  <li>Le `title` doit faire 100 caractères ou moins. Le `post` doit faire 5 000 caractères ou moins. Le `post` et le `title` peuvent contenir tous les caractères sauf \< et >.</li>
  <li>L'ID de playlist peut être trouvé en ouvrant la playlist dans un navigateur et en copiant la valeur après `list=`. L'utilisateur authentifié et le channel doivent être propriétaires de la playlist pour ajouter des vidéos.</li>
  <li>Si votre vidéo ne se termine pas par une extension vidéo connue telle que mp4, utilisez le paramètre `isVideo`. Consultez le [point de terminaison /post](/apis/post/post) pour plus de détails.</li>
  <li>Le champ `publishAt` permet à YouTube de contrôler l'heure de publication.
  La vidéo restera privée jusqu'à l'heure de publication où elle sera rendue publique.
  Si l'heure de publication est dans le passé, la vidéo sera rendue publique immédiatement.
  N'utilisez pas le champ `scheduleDate` de post lorsque vous utilisez le champ `publishAt`.</li>
  <li>Le champ `containsSyntheticMedia` est utilisé pour indiquer qu'une vidéo contient un contenu réaliste altéré ou synthétique (A/S) : faire dire ou faire à une personne réelle quelque chose qu'elle n'a pas réellement dit ou fait, modifier des images d'un événement ou d'un lieu réel, générer une scène d'apparence réaliste qui n'a pas réellement eu lieu.</li>
  <li>`license` — définit le type de licence de la vidéo. Valeurs acceptées : `"youtube"` (Standard YouTube License, par défaut) ou `"creativeCommon"` (Creative Commons - Attribution).</li>
  <li>`embeddable` — booléen (ou les chaînes `"true"` / `"false"`). Contrôle si la vidéo peut être intégrée sur des sites web tiers. Par défaut : `true`.</li>
  <li>`publicStatsViewable` — booléen (ou les chaînes `"true"` / `"false"`). Contrôle si le **panneau de statistiques étendu** de la page de visionnage de la vidéo est publiquement visible. Le nombre de vues et de mentions J'aime de base reste publiquement visible quel que soit ce paramètre. Par défaut : `true`. Consultez [`status.publicStatsViewable` dans la référence de l'API YouTube Data](https://developers.google.com/youtube/v3/docs/videos#status.publicStatsViewable) pour plus de détails.</li>
  <li>Consultez [YouTube Media Guidelines](/media-guidelines/youtube) pour plus d'informations.</li>
</ul>

<Note>
  **Monétisation et contrôles de contenu**

  Les champs `madeForKids`, `license`, `embeddable` et `publicStatsViewable` peuvent être définis via l'API Ayrshare au moment du téléversement. Cependant, les bascules de monétisation directe (activation/désactivation des publicités), la sélection du type d'annonce (pre-roll, mid-roll, post-roll), le partage des revenus et le Content ID nécessitent des identifiants YouTube CMS — disponibles uniquement pour les MCNs et les propriétaires de contenu entreprise — et **ne sont pas** disponibles via l'OAuth YouTube standard ni via l'API Ayrshare.
</Note>

## YouTube Shorts

Un YouTube Short est une vidéo courte au format vertical pouvant durer jusqu'à trois minutes.
Ils sont similaires aux vidéos TikTok et aux Reels Instagram ou Facebook.

### Publier des YouTube Shorts

Vous pouvez publier une vidéo YouTube Shorts allant jusqu'à 3 minutes en ajoutant le paramètre `shorts` à l'objet `youTubeOptions`.

```json YouTube Shorts Post theme={"system"}
{
  "youTubeOptions": {
    "shorts": true
  }
}
```

Le hashtag <i>#shorts</i> sera ajouté à la description YouTube.

### Informations importantes sur YouTube Shorts

<ul class="custom-bullets">
  <li>
    Envoyer une vidéo comme Short est une indication à YouTube que vous souhaitez que la vidéo apparaisse
    comme un Short, mais cela ne garantit pas qu'elle apparaîtra comme un Short. La vidéo doit répondre aux exigences des
    [Short videos](/media-guidelines/youtube#shorts), telles qu'une durée de 3 minutes ou moins et
    un rapport d'aspect vertical de 9:16 pour être considérée comme un Short par YouTube.
  </li>

  <li>Les YouTube Shorts ne prennent pas en charge les miniatures.</li>

  <li>
    Informations supplémentaires sur l'utilisation de l'[API pour publier des YouTube
    Shorts](https://www.ayrshare.com/blog/post-youtube-shorts-with-an-api/).
  </li>
</ul>

## Miniatures YouTube

<Info>
  Les miniatures personnalisées nécessitent un **YouTube channel vérifié**. La raison la plus courante pour laquelle une miniature n'est pas appliquée (alors que la vidéo est bien publiée) est un channel non vérifié — vérifiez-le sur [https://www.youtube.com/verify](https://www.youtube.com/verify) (vérification par téléphone). Votre `thumbNail` doit également être un **PNG ou JPG/JPEG**, faire **2 Mo ou moins**, et être servi depuis une **URL accessible** ; Ayrshare valide ces éléments avant la publication lorsque c'est possible. Lorsqu'une vidéo est publiée mais que la miniature échoue, le résultat YouTube conserve `status: "success"` et ajoute un tableau `warnings` (`feature: "thumbnail"`, `code: 307`) décrivant l'échec. Consultez [YouTube Thumbnail Not Applied (Unverified Channel)](/help-center/technical-support/youtube_thumbnail_unverified_channel) pour la correction complète.
</Info>

### Ajouter des miniatures YouTube

Les miniatures YouTube et d'autres fonctionnalités, comme le téléversement de vidéos de 15 minutes, nécessitent la vérification de votre numéro de téléphone.
Un `thumbNail` est une URL d'un JPEG ou PNG de moins de 2 Mo. L'extension du fichier doit se terminer par png, jpg ou jpeg.

```json YouTube Thumbnail theme={"system"}
{
  "youTubeOptions": {
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg"
  }
}
```

Les YouTube Shorts ne prennent actuellement pas en charge les miniatures.

### Activer les miniatures dans YouTube Studio

Vous devez disposer des autorisations YouTube pour publier des miniatures. Dans [YouTube Studio](https://studio.youtube.com/), allez dans *Settings->Channel*. Sélectionnez « *Feature Eligibility* » et cliquez sur « *Features that require phone verification* ». Saisissez votre numéro de téléphone pour l'activer.

<img class="center" src="https://mintcdn.com/ayrshare-docs/Nmrhj2Gh7WSf62Bh/images/apis/post/yt-thumb.webp?fit=max&auto=format&n=Nmrhj2Gh7WSf62Bh&q=85&s=67855a44b4ab5612d5f89df9db511556" alt="YouTube Studio" width="1200" height="781" data-path="images/apis/post/yt-thumb.webp" />

<Warning>
  YouTube peut prendre jusqu'à 24 heures pour activer les miniatures après la vérification de votre numéro de téléphone. Notez que YouTube détermine l'éligibilité à l'ajout de miniatures. Une vérification téléphonique « activée » ne garantit pas que YouTube autorisera le téléversement de miniatures.

  Si vous avez été vérifié depuis 24 heures et rencontrez toujours des problèmes, vérifiez que :

  1. Vous êtes capable de téléverser manuellement des miniatures dans YouTube Studio.
  2. Si vous travaillez avec un Brand Content Owner Account (souvent utilisé pour les channels d'entreprise ou d'organisation), assurez-vous d'avoir les autorisations nécessaires. Nous recommandons les droits « Owner ».
  3. Si vous rencontrez toujours des problèmes, consultez cette vidéo sur la [résolution du problème de miniature](https://www.youtube.com/watch?v=1bFmX2uQk0Y).
</Warning>

## Vidéo : publier sur YouTube via l'API

<iframe width="380" height="200" src="https://www.youtube.com/embed/UkisNgVxubg" title="Posting to YouTube API" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" />

## Limites de téléversement

YouTube limite le nombre de vidéos qu'un channel peut téléverser sur une période de 24 heures via l'API YouTube.

<ul class="custom-bullets">
  <li>
    Selon la localisation d'un créateur, un channel peut être en mesure d'augmenter sa limite quotidienne en
    obtenant l'accès à des fonctionnalités avancées. Pour en savoir plus, consultez cet
    [article](https://notifications.google.com/g/p/ACnX6LbjUElgT-OfRLVjenkpdldv6pIJ5JYGZyPGTdJwRYmo3fXFkfXJsPGnswgns0BjJ6Bjxn2bqpqfBt6gBdkLoqESKA7mqLNllzcR2qnYUJn5KlJN5jPqCWl6DGr58cZEt94mMvxXATN6_PaBR1RYEpNMTYWN).
  </li>

  <li>
    Les limites peuvent varier selon le pays/la région ou l'historique du channel. Les strikes pour infraction aux droits d'auteur peuvent affecter l'éligibilité de
    l'historique du channel, et les [strikes des Community
    Guidelines](https://support.google.com/youtube/answer/2802032) affectent la quantité qu'un channel peut
    téléverser.
  </li>
</ul>

Si vous recevez une erreur de limite de téléversement, veuillez attendre et réessayer dans 24 heures.

## Liens dans la description

Vous devez activer les **Advanced Features** dans YouTube Studio pour disposer de liens cliquables dans la description de la vidéo YouTube.

Allez dans **YouTube Studio -> Settings -> Channel -> Feature Eligibility -> Advanced Features -> Access Features** pour activer les fonctionnalités avancées.

<img class="center" src="https://mintcdn.com/ayrshare-docs/Nmrhj2Gh7WSf62Bh/images/apis/post/YT-settings.webp?fit=max&auto=format&n=Nmrhj2Gh7WSf62Bh&q=85&s=129f12886c2896167f936dcc7c633234" alt="YouTube Feature Eligibility" width="1000" height="661" data-path="images/apis/post/YT-settings.webp" />

## Playlists

Vous pouvez ajouter des vidéos à une playlist YouTube en incluant `playListId` dans l'objet `youTubeOptions`.
Assurez-vous que l'utilisateur authentifié et le channel sont propriétaires de la playlist.

```json YouTube Playlist theme={"system"}
{
  "youTubeOptions": {
    "playListId": "PLrav6EfwgDX5"
  }
}
```

## Sous-titres / Légendes pour vidéos

Vous pouvez ajouter des sous-titres YouTube, également appelés légendes YouTube, aux vidéos en incluant un [fichier SRT](https://en.wikipedia.org/wiki/SubRip) ou un [fichier SBV](https://support.google.com/youtube/answer/2734698) YouTube. Utilisez le champ `subTitleUrl` dans l'objet `youTubeOptions` pour spécifier l'URL de votre fichier SRT ou SBV.

```json YouTube Subtitles theme={"system"}
{
  "youTubeOptions": {
    "title": "My new post from Ayrshare to Youtube",
    "subTitleUrl": "https://img.ayrshare.com/012/captions.srt",
    "subTitleLanguage": "en",
    "subTitleName": "English"
  }
}
```

<ul class="custom-bullets">
  <li>
    `subTitleUrl` : un fichier SRT ou SBV valide. L'URL doit commencer par `https://`, se terminer par `.srt` ou
    `.sbv` et être un fichier SRT ou SBV valide. Le fichier doit faire moins de 100 Mo.
  </li>

  <li>
    `subTitleLanguage` : facultatif. La langue des sous-titres. Doit être un [code de langue
    valide](/iso-codes/language). Valeur par défaut : « en ».
  </li>

  <li>
    `subTitleName` : facultatif. Le nom de la piste de légendes. Le nom est destiné à être visible par
    l'utilisateur comme option pendant la lecture. La longueur maximale prise en charge est de 150 caractères.
    Valeur par défaut : « English ».
  </li>
</ul>

<Note>
  **Qu'est-ce qu'un fichier SRT ou SBV ?**

  SRT (SubRip Subtitle) et SBV (YouTube SubViewer) sont des formats de fichier de sous-titres utilisés pour afficher
  du texte chronométré dans les vidéos. La principale différence est que SRT utilise des horodatages au format HH:MM:SS,MS avec
  des séparateurs en flèches, tandis que SBV utilise le format HH:MM:SS.MS avec des virgules.

  ```text theme={"system"}
  ## SRT Format Example
  1
  00:00:01,000 --> 00:00:04,000
  Welcome to our tutorial on subtitle formats.

  2
  00:00:04,500 --> 00:00:08,000
  Today we'll learn about SRT and SBV files.

  ## SBV Format Example
  0:00:01.000,0:00:04.000
  Welcome to our tutorial on subtitle formats.

  0:00:04.500,0:00:08.000
  Today we'll learn about SRT and SBV files.
  ```
</Note>

## Tags

Vous pouvez ajouter des tags YouTube à vos vidéos en incluant le tableau `tags` dans l'objet `youTubeOptions`.
Les tags doivent faire au moins 2 caractères chacun et la longueur totale de tous les tags doit être de 500 caractères ou moins.

```json YouTube Tags theme={"system"}
{
  "youTubeOptions": {
    "tags": ["dancing", "dogs"]
  }
}
```

## Mentions YouTube

Bien que vous puissiez ajouter un `@handle` à une publication YouTube, YouTube ne prend pas en charge la résolution des mentions dans le texte de la publication.
Le `@handle` restera sous forme de texte simple.

## Limites de caractères

Consultez [YouTube Character Limits](/help-center/technical-support/character_limits#youtube-character-limits) pour plus d'informations.

## Points de terminaison supplémentaires

<Card title="Récupérer les catégories YouTube" icon="code" href="/apis/utils/youtube-categories" horizontal />

<Card title="Définir un watermark YouTube" icon="code" href="/apis/utils/set-youtube-watermark" horizontal />

<Card title="Supprimer un watermark YouTube" icon="code" href="/apis/utils/remove-youtube-watermark" horizontal />