YouTube API

​

Публікація у YouTube

​

Огляд публікації

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

​

Опціональні поля 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",
  }
}

• title має бути не більше 100 символів. post — не більше 5 000 символів. post і title можуть містити будь-які символи, крім < і >.
• Playlist Id можна знайти, відкривши плейлист у браузері та скопіювавши значення після list=. Автентифікований користувач і канал повинні бути власниками плейлиста, щоб додавати відео.
• Якщо ваше відео не закінчується відомим розширенням, як-от mp4, використайте параметр isVideo. Деталі див. в ендпоінті /post.
• Поле publishAt дозволяє YouTube керувати часом публікації. Відео буде private до моменту публікації, коли стане public. Якщо час публікації в минулому, відео буде негайно опубліковано як public. Не використовуйте поле scheduleDate посту разом із publishAt.
• Поле containsSyntheticMedia використовується для розкриття того, що відео містить реалістичний Altered or Synthetic (A/S) контент: змушує реальну людину виглядати так, ніби вона сказала чи зробила те, чого насправді не робила; змінює кадри реальної події чи місця; генерує реалістичну сцену, якої насправді не було.
• license — задає тип ліцензії відео. Допустимі значення: "youtube" (Standard YouTube License, за замовчуванням) або "creativeCommon" (Creative Commons - Attribution).
• embeddable — Boolean (або рядки "true" / "false"). Керує тим, чи можна вбудовувати відео на сторонніх сайтах. За замовчуванням: true.
• publicStatsViewable — Boolean (або рядки "true" / "false"). Керує тим, чи є розширена панель статистики на сторінці перегляду відео публічно доступною. Базові кількість переглядів і лайків залишаються публічно видимими незалежно від цього налаштування. За замовчуванням: true. Деталі див. у status.publicStatsViewable у довіднику YouTube Data API.
• Докладніше див. YouTube Media Guidelines.

​

YouTube Shorts

​

Публікація YouTube Shorts

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

​

Важлива інформація про YouTube Shorts

• Надсилання відео як Short — це вказівка YouTube, що ви хочете, щоб відео з’явилося як Short, але не гарантує це. Відео має відповідати вимогам Short video, зокрема тривалість не більше 3 хвилин і вертикальне співвідношення сторін 9:16, щоб YouTube вважав його Short.
• YouTube Shorts не підтримують мініатюри.
• Додаткова інформація про використання API для публікації YouTube Shorts.

​

Мініатюри YouTube

​

Додавання мініатюр YouTube

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

​

Увімкнення мініатюр у YouTube Studio

​

Відео: публікація у YouTube через API

​

Ліміти завантаження

• Залежно від місцезнаходження творця, канал може збільшити свій добовий ліміт, отримавши доступ до розширених функцій. Дізнатися більше у цій статті.
• Ліміти можуть різнитися залежно від країни/регіону або історії каналу. Copyright strikes можуть впливати на право за історією каналу, а Community Guidelines strikes впливатимуть на те, скільки канал може завантажувати.

​

Посилання в описі

​

Плейлисти

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

​

Субтитри / підписи до відео

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

• subTitleUrl: валідний SRT- або SBV-файл. URL має починатися з https:// та закінчуватися на .srt або .sbv і бути валідним SRT- або SBV-файлом. Файл має бути меншим за 100 MB.
• subTitleLanguage: опціонально. Мова субтитрів. Має бути валідним кодом мови. За замовчуванням: “en”.
• subTitleName: опціонально. Назва треку субтитрів. Ця назва відображається користувачу як опція під час відтворення. Максимальна довжина — 150 символів. За замовчуванням: “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.

​

Теги

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

​

Згадки у YouTube

​

Обмеження на символи

​

Додаткові ендпоінти