YouTube
Взаимодействие с видео, каналами и плейлистами YouTube
YouTube — крупнейшая в мире платформа для обмена видео, на которой размещаются миллиарды видео и обслуживается более 2 миллиардов авторизованных пользователей в месяц.
С помощью обширных возможностей API YouTube вы можете:
- Искать контент: Находить релевантные видео в огромной библиотеке YouTube с использованием конкретных ключевых слов, фильтров и параметров
- Получать метаданные: Извлекать подробную информацию о видео, включая заголовки, описания, количество просмотров и метрики вовлеченности
- Анализировать тренды: Определять популярный контент и актуальные темы в определенных категориях или регионах
- Извлекать инсайты: Собирать данные о предпочтениях аудитории, производительности контента и моделях вовлеченности
В AACFlow интеграция с YouTube позволяет вашим агентам программно искать и анализировать контент YouTube в рамках своих рабочих процессов. Это позволяет реализовать мощные сценарии автоматизации, требующие актуальной информации о видео. Ваши агенты могут искать обучающие видео, исследовать тренды контента, собирать информацию с образовательных каналов или отслеживать конкретных создателей на предмет новых загрузок. Эта интеграция устраняет разрыв между вашими AI-рабочими процессами и крупнейшим в мире репозиторием видео, позволяя создавать более сложные и осведомленные о контенте автоматизации. Подключая AACFlow к YouTube, вы можете создавать агентов, которые остаются в курсе последней информации, предоставляют более точные ответы и приносят больше пользы пользователям — все без необходимости ручного вмешательства или написания пользовательского кода.
Интегрируйте YouTube в рабочий процесс. Возможности: поиск видео, получение популярных видео, получение деталей видео, получение категорий видео, получение информации о канале, получение всех видео с канала, получение плейлистов канала, получение элементов плейлиста и получение комментариев к видео.
Получение подробной информации о канале YouTube, включая статистику, брендинг и детали контента.
| Параметр | Тип | Обязательный | Описание |
|---|
channelId | string | Нет | ID канала YouTube, начинающийся с "UC" (24-символьная строка, используйте либо channelId, либо username) |
username | string | Нет | Имя пользователя канала YouTube (используйте либо channelId, либо username) |
apiKey | string | Да | Ключ API YouTube |
| Параметр | Тип | Описание |
|---|
channelId | string | ID канала YouTube |
title | string | Название канала |
description | string | Описание канала |
subscriberCount | number | Количество подписчиков (0, если скрыто) |
videoCount | number | Количество публичных видео |
viewCount | number | Общее количество просмотров канала |
publishedAt | string | Дата создания канала |
thumbnail | string | URL миниатюры/аватара канала |
customUrl | string | Пользовательский URL канала (хэндл) |
country | string | Страна, с которой ассоциирован канал |
uploadsPlaylistId | string | ID плейлиста, содержащего все загрузки канала (используйте с playlist_items) |
bannerImageUrl | string | URL баннера канала |
hiddenSubscriberCount | boolean | Скрыто ли количество подписчиков |
Получение всех публичных плейлистов с конкретного канала YouTube.
| Параметр | Тип | Обязательный | Описание |
|---|
channelId | string | Да | ID канала YouTube, начинающийся с "UC" (24-символьная строка), для получения плейлистов |
maxResults | number | Нет | Максимальное количество возвращаемых плейлистов (1-50) |
pageToken | string | Нет | Токен страницы для пагинации (из nextPageToken предыдущего ответа) |
apiKey | string | Да | Ключ API YouTube |
| Параметр | Тип | Описание |
|---|
items | array | Массив плейлистов с канала |
↳ playlistId | string | ID плейлиста YouTube |
↳ title | string | Заголовок плейлиста |
↳ description | string | Описание плейлиста |
↳ thumbnail | string | URL миниатюры плейлиста |
↳ itemCount | number | Количество видео в плейлисте |
↳ publishedAt | string | Дата создания плейлиста |
↳ channelTitle | string | Название канала |
totalResults | number | Общее количество плейлистов в канале |
nextPageToken | string | Токен для доступа к следующей странице результатов |
Поиск видео с конкретного канала YouTube с опциями сортировки. Для получения полного списка видео канала используйте channel_info для получения uploadsPlaylistId, затем используйте playlist_items.
| Параметр | Тип | Обязательный | Описание |
|---|
channelId | string | Да | ID канала YouTube, начинающийся с "UC" (24-символьная строка), для получения видео |
maxResults | number | Нет | Максимальное количество возвращаемых видео (1-50) |
order | string | Нет | Порядок сортировки: "date" (сначала новые, по умолчанию), "rating", "relevance", "title", "viewCount" |
pageToken | string | Нет | Токен страницы для пагинации (из nextPageToken предыдущего ответа) |
apiKey | string | Да | Ключ API YouTube |
| Параметр | Тип | Описание |
|---|
items | array | Массив видео с канала |
↳ videoId | string | ID видео YouTube |
↳ title | string | Заголовок видео |
↳ description | string | Описание видео |
↳ thumbnail | string | URL миниатюры видео |
↳ publishedAt | string | Дата публикации видео |
↳ channelTitle | string | Название канала |
totalResults | number | Общее количество видео в канале |
nextPageToken | string | Токен для доступа к следующей странице результатов |
Получение комментариев верхнего уровня к видео YouTube с деталями автора и вовлеченности.
| Параметр | Тип | Обязательный | Описание |
|---|
videoId | string | Да | ID видео YouTube (11-символьная строка, например, "dQw4w9WgXcQ") |
maxResults | number | Нет | Максимальное количество возвращаемых комментариев (1-100) |
order | string | Нет | Порядок комментариев: "time" (сначала новые) или "relevance" (сначала наиболее релевантные) |
pageToken | string | Нет | Токен страницы для пагинации (из nextPageToken предыдущего ответа) |
apiKey | string | Да | Ключ API YouTube |
| Параметр | Тип | Описание |
|---|
items | array | Массив комментариев верхнего уровня к видео |
↳ commentId | string | ID комментария |
↳ authorDisplayName | string | Отображаемое имя автора комментария |
↳ authorChannelUrl | string | URL канала автора комментария |
↳ authorProfileImageUrl | string | URL изображения профиля автора комментария |
↳ textDisplay | string | Текст комментария (в формате HTML) |
↳ textOriginal | string | Текст комментария (обычный текст) |
↳ likeCount | number | Количество лайков у комментария |
↳ publishedAt | string | Когда был опубликован комментарий |
↳ updatedAt | string | Когда комментарий был последний раз отредактирован |
↳ replyCount | number | Количество ответов на этот комментарий |
totalResults | number | Общее количество доступных веток комментариев |
nextPageToken | string | Токен для доступа к следующей странице результатов |
Получение видео из плейлиста YouTube. Можно использовать с плейлистом загрузок канала для получения всех видео канала.
| Параметр | Тип | Обязательный | Описание |
|---|
playlistId | string | Да | ID плейлиста YouTube, начинающийся с "PL" или "UU" (34-символьная строка). Используйте uploadsPlaylistId из channel_info для получения всех видео канала. |
maxResults | number | Нет | Максимальное количество возвращаемых видео (1-50) |
pageToken | string | Нет | Токен страницы для пагинации (из nextPageToken предыдущего ответа) |
apiKey | string | Да | Ключ API YouTube |
| Параметр | Тип | Описание |
|---|
items | array | Массив видео в плейлисте |
↳ videoId | string | ID видео YouTube |
↳ title | string | Заголовок видео |
↳ description | string | Описание видео |
↳ thumbnail | string | URL миниатюры видео |
↳ publishedAt | string | Дата добавления в плейлист |
↳ channelTitle | string | Название канала владельца плейлиста |
↳ position | number | Позиция в плейлисте (0-индексированная) |
↳ videoOwnerChannelId | string | ID канала владельца видео |
↳ videoOwnerChannelTitle | string | Название канала владельца видео |
totalResults | number | Общее количество элементов в плейлисте |
nextPageToken | string | Токен для доступа к следующей странице результатов |
Поиск видео на YouTube с использованием YouTube Data API. Поддерживает расширенную фильтрацию по каналу, диапазону дат, продолжительности, категории, качеству, субтитрам, прямым трансляциям и многому другому.
| Параметр | Тип | Обязательный | Описание |
|---|
query | string | Да | Поисковый запрос для видео YouTube |
maxResults | number | Нет | Максимальное количество возвращаемых видео (1-50) |
pageToken | string | Нет | Токен страницы для пагинации (из nextPageToken предыдущего ответа) |
apiKey | string | Да | Ключ API YouTube |
channelId | string | Нет | Фильтровать результаты по конкретному ID канала YouTube, начинающемуся с "UC" (24-символьная строка) |
publishedAfter | string | Нет | Возвращать только видео, опубликованные после этой даты (формат RFC 3339: "2024-01-01T00:00:00Z") |
publishedBefore | string | Нет | Возвращать только видео, опубликованные до этой даты (формат RFC 3339: "2024-01-01T00:00:00Z") |
videoDuration | string | Нет | Фильтр по длительности видео: "short" (<4 мин), "medium" (4-20 мин), "long" (>20 мин), "any" |
order | string | Нет | Сортировка результатов по: "date", "rating", "relevance" (по умолчанию), "title", "videoCount", "viewCount" |
videoCategoryId | string | Нет | Фильтр по ID категории YouTube (например, "10" для Музыки, "20" для Игр). Используйте video_categories для получения списка ID. |
videoDefinition | string | Нет | Фильтр по качеству видео: "high" (HD), "standard", "any" |
videoCaption | string | Нет | Фильтр по доступности субтитров: "closedCaption" (есть субтитры), "none" (нет субтитров), "any" |
eventType | string | Нет | Фильтр по статусу прямой трансляции: "live" (сейчас в прямом эфире), "upcoming" (запланирована), "completed" (прошедшие трансляции) |
regionCode | string | Нет | Возвращать результаты, релевантные конкретному региону (код страны ISO 3166-1 alpha-2, например, "US", "GB") |
relevanceLanguage | string | Нет | Возвращать результаты, наиболее релевантные языку (код ISO 639-1, например, "en", "es") |
safeSearch | string | Нет | Уровень фильтрации контента: "moderate" (по умолчанию), "none", "strict" |
| Параметр | Тип | Описание |
|---|
items | array | Массив видео YouTube, соответствующих поисковому запросу |
↳ videoId | string | ID видео YouTube |
↳ title | string | Заголовок видео |
↳ description | string | Описание видео |
↳ thumbnail | string | URL миниатюры видео |
↳ channelId | string | ID канала, загрузившего видео |
↳ channelTitle | string | Название канала |
↳ publishedAt | string | Дата публикации видео |
↳ liveBroadcastContent | string | Статус прямой трансляции: "none", "live" или "upcoming" |
totalResults | number | Общее количество доступных результатов поиска |
nextPageToken | string | Токен для доступа к следующей странице результатов |
Получение самых популярных/трендовых видео на YouTube. Можно фильтровать по региону и категории видео.
| Параметр | Тип | Обязательный | Описание |
|---|
regionCode | string | Нет | Код страны ISO 3166-1 alpha-2 для получения трендовых видео (например, "US", "GB", "JP"). По умолчанию US. |
videoCategoryId | string | Нет | Фильтр по ID категории видео (например, "10" для Музыки, "20" для Игр, "17" для Спорта) |
maxResults | number | Нет | Максимальное количество возвращаемых трендовых видео (1-50) |
pageToken | string | Нет | Токен страницы для пагинации (из nextPageToken предыдущего ответа) |
apiKey | string | Да | Ключ API YouTube |
| Параметр | Тип | Описание |
|---|
items | array | Массив трендовых видео |
↳ videoId | string | ID видео YouTube |
↳ title | string | Заголовок видео |
↳ description | string | Описание видео |
↳ thumbnail | string | URL миниатюры видео |
↳ channelId | string | ID канала |
↳ channelTitle | string | Название канала |
↳ publishedAt | string | Дата публикации видео |
↳ viewCount | number | Количество просмотров |
↳ likeCount | number | Количество лайков |
↳ commentCount | number | Количество комментариев |
↳ duration | string | Продолжительность видео в формате ISO 8601 |
totalResults | number | Общее количество доступных трендовых видео |
nextPageToken | string | Токен для доступа к следующей странице результатов |
Получение списка категорий видео, доступных на YouTube. Используйте это для обнаружения действительных ID категорий для фильтрации результатов поиска и трендов.
| Параметр | Тип | Обязательный | Описание |
|---|
regionCode | string | Нет | Код страны ISO 3166-1 alpha-2 для получения категорий (например, "US", "GB", "JP"). По умолчанию US. |
hl | string | Нет | Язык для заголовков категорий (код ISO 639-1, например, "en", "es", "fr"). По умолчанию английский. |
apiKey | string | Да | Ключ API YouTube |
| Параметр | Тип | Описание |
|---|
items | array | Массив категорий видео, доступных в указанном регионе |
↳ categoryId | string | ID категории для использования в фильтрах поиска/трендов (например, "10" для Музыки) |
↳ title | string | Человекочитаемое название категории |
↳ assignable | boolean | Можно ли помечать видео этой категорией |
totalResults | number | Общее количество доступных категорий |
Получение подробной информации о конкретном видео YouTube, включая статистику, детали контента, информацию о прямой трансляции и метаданные.
| Параметр | Тип | Обязательный | Описание |
|---|
videoId | string | Да | ID видео YouTube (11-символьная строка, например, "dQw4w9WgXcQ") |
apiKey | string | Да | Ключ API YouTube |
| Параметр | Тип | Описание |
|---|
videoId | string | ID видео YouTube |
title | string | Заголовок видео |
description | string | Описание видео |
channelId | string | ID канала |
channelTitle | string | Название канала |
publishedAt | string | Дата и время публикации |
duration | string | Продолжительность видео в формате ISO 8601 (например, "PT4M13S" для 4 мин 13 сек) |
viewCount | number | Количество просмотров |
likeCount | number | Количество лайков |
commentCount | number | Количество комментариев |
favoriteCount | number | Количество добавлений в избранное |
thumbnail | string | URL миниатюры видео |
tags | array | Теги видео |
categoryId | string | ID категории видео YouTube |
definition | string | Качество видео: "hd" или "sd" |
caption | string | Доступны ли субтитры: "true" или "false" |
licensedContent | boolean | Является ли видео лицензированным контентом |
privacyStatus | string | Статус конфиденциальности видео: "public", "private" или "unlisted" |
liveBroadcastContent | string | Статус прямой трансляции: "live", "upcoming" или "none" |
defaultLanguage | string | Язык по умолчанию для метаданных видео |
defaultAudioLanguage | string | Язык аудио по умолчанию для видео |
isLiveContent | boolean | Является ли это видео прямой трансляцией или было ею |
scheduledStartTime | string | Запланированное время начала для предстоящих прямых трансляций (ISO 8601) |
actualStartTime | string | Когда прямая трансляция фактически началась (ISO 8601) |
actualEndTime | string | Когда прямая трансляция завершилась (ISO 8601) |
concurrentViewers | number | Текущее количество зрителей (только для активных прямых трансляций) |
activeLiveChatId | string | ID живого чата для трансляции (только для активных прямых трансляций) |
