API YouTube

​

Publier sur YouTube

​

Vue d’ensemble de la publication

{
  // 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"
  }
}

​

Champs facultatifs des publications YouTube

{
  // 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",
  }
}

• 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 >.
• 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.
• 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 pour plus de détails.
• 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.
• 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.
• 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).
• 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.
• 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 pour plus de détails.
• Consultez YouTube Media Guidelines pour plus d’informations.

​

YouTube Shorts

​

Publier des YouTube Shorts

{
  "youTubeOptions": {
    "shorts": true
  }
}

​

Informations importantes sur YouTube Shorts

• 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, 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.
• Les YouTube Shorts ne prennent pas en charge les miniatures.
• Informations supplémentaires sur l’utilisation de l’API pour publier des YouTube Shorts.

​

Miniatures YouTube

​

Ajouter des miniatures YouTube

{
  "youTubeOptions": {
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg"
  }
}

​

Activer les miniatures dans YouTube Studio

​

Vidéo : publier sur YouTube via l’API

​

Limites de téléversement

• 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.
• 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 affectent la quantité qu’un channel peut téléverser.

​

Liens dans la description

​

Playlists

{
  "youTubeOptions": {
    "playListId": "PLrav6EfwgDX5"
  }
}

​

Sous-titres / Légendes pour vidéos

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

• 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.
• subTitleLanguage : facultatif. La langue des sous-titres. Doit être un code de langue valide. Valeur par défaut : « en ».
• 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 ».

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

​

Tags

{
  "youTubeOptions": {
    "tags": ["dancing", "dogs"]
  }
}

​

Mentions YouTube

​

Limites de caractères

​

Points de terminaison supplémentaires