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 bytes
  "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 кодових точок Unicode. post — не більше 5 000 байтів. Ayrshare замінює < і > на [ і ) перед надсиланням, оскільки YouTube їх не приймає.
• Playlist Id можна знайти, відкривши плейлист у браузері та скопіювавши значення після list=. Автентифікований користувач і канал повинні бути власниками плейлиста, щоб додавати відео.
• Якщо ваше відео не закінчується відомим розширенням, як-от mp4, використайте параметр isVideo. Деталі див. в ендпоінті /post.
• Поле publishAt дозволяє YouTube керувати часом публікації. Відео буде private до моменту публікації, коли стане public. Якщо час публікації в минулому, відео буде негайно опубліковано як public. Не використовуйте поле scheduleDate посту разом із publishAt.
• Поле containsSyntheticMedia використовується для розкриття того, що відео містить реалістичний Altered or Synthetic (A/S) контент: змушує реальну людину виглядати так, ніби вона сказала чи зробила те, чого насправді не робила; змінює кадри реальної події чи місця; генерує реалістичну сцену, якої насправді не було. Див. Розкриття AI-контенту.
• 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.

​

Розкриття AI-контенту

{
  "post": "Generated with a little help from a model",
  "platforms": ["youtube"],
  "mediaUrls": ["https://img.ayrshare.com/012/vid.mp4"],
  "youTubeOptions": {
    "title": "Your Best Title",
    "containsSyntheticMedia": true
  }
}

• containsSyntheticMedia: булеве значення, встановлене у true, щоб розкрити, що відео містить реалістичний Altered or Synthetic контент. За замовчуванням false. Якщо параметр не вказано, Ayrshare не надсилає жодного розкриття разом із завантаженням. YouTube все одно може застосувати власну мітку (див. нижче).
• YouTube вимагає розкриття, якщо відео робить будь-що з переліченого: змушує реальну людину виглядати так, ніби вона сказала чи зробила те, чого насправді не казала й не робила; змінює кадри реальної події чи місця; або генерує реалістичну сцену, якої насправді не було.
• Розкриття вмикають лише true та “true”. Будь-яке інше значення, зокрема false, “yes” чи 1, не надсилає розкриття і не повертає жодного попередження.
• Параметр встановлює відповідь Yes (Так) на питання AI use (Використання ШІ) на сторінці Details відео в YouTube Studio, тож після публікації ви можете перевірити це там.
• Цей параметр є лише самостійним розкриттям, і це не єдиний спосіб, у який може з’явитися мітка. Ayrshare не виявляє й не визначає, чи є ваше медіа згенерованим ШІ. YouTube також може позначити відео самостійно, наприклад контент, створений за допомогою його інструментів GenAI, або файли з C2PA Content Credentials.

​

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

​

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

​

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