Платформа
YouTube
Публичный поиск, аналитика канала, комментарии и субтитры.
YouTube
Приложение YouTube работает в двух режимах. Без подключения канала агент исследует публичные видео и каналы. После подключения он получает доступ к вашему каналу, комментариям, плейлистам и субтитрам и может выполнять согласованные действия от имени канала.
Назначение
YouTube помогает:
- искать свежие и популярные видео по теме;
- изучать публичные каналы и форматы конкурентов;
- получать агрегированные показатели своего канала и роликов;
- разбирать комментарии и готовить ответы;
- читать и скачивать доступные субтитры;
- вести плейлисты, менять описание ролика и управлять подписками после подтверждения.
Подключение
Поиск и анализ публичных данных работают без подключения. Канал подключает владелец рабочего пространства:
- Откройте YouTube → Настройки.
- Нажмите Подключить канал.
- Войдите в Google под аккаунтом, которому принадлежит канал или выдана роль в YouTube Studio.
- Если аккаунту доступно несколько каналов, выберите нужный.
- Разрешите запрошенный доступ и дождитесь возврата в Promto.
Ключи и токены вручную вводить не нужно. При отключении Promto отзывает доступ на стороне Google и удаляет сохранённый токен.
До завершения проверки OAuth-приложения Google подключение может действовать семь дней, после чего вход потребуется повторить.
Интерфейс
На Главной расположены сценарии поиска тем, анализа своего и чужого канала, комментариев, субтитров и улучшения заголовков.
В Настройках видны название канала, ссылка на него, число подписчиков, видео и просмотров, состояние доступа и кнопка отключения. Если канал не подключён, экран отдельно сообщает, что публичное исследование по-прежнему доступно.
Возможности агента
Основной агент использует promto_youtube.
| Доступ | Действия |
|---|---|
| Публичный поиск | search, get_channel, list_channel_videos, get_video, video_categories |
| Публичные обсуждения и дорожки | list_comments, list_captions |
| Подключённый канал | my_channel, my_videos, list_playlists, list_subscriptions, download_caption |
| Действия от имени канала | reply_comment, create_playlist, add_to_playlist, update_video, rate_video, subscribe, unsubscribe |
Для публичного исследования подключённый аккаунт не нужен. Все действия от имени канала требуют подключения и соответствующей роли пользователя.
Сценарии
Найти популярные темы
Агент ищет свежие ролики по заданной теме, региону и языку, сортирует найденное по просмотрам и выделяет повторяющиеся форматы. Это рейтинг результатов поиска, а не официальный раздел YouTube «В тренде».
Разобрать свой канал
Агент получает агрегированные счётчики и последние видео, сравнивает просмотры и регулярность публикаций. Он не подменяет данные YouTube Studio, которых нет в этом подключении.
Подготовить ответы на комментарии
Агент отделяет вопросы от спама и пишет черновики. Текст публикуется от имени канала только после вашей проверки и явного согласия.
Ограничения и безопасность
- Поиск расходует 100 единиц дневной квоты YouTube Data API; обычное чтение обычно расходует одну. Не запускайте циклы одинаковых поисков.
- Дневной бюджет API по умолчанию составляет 10 000 единиц на проект.
- Отдельного действия для официального раздела «В тренде» нет.
- Метрики YouTube Analytics — удержание, CTR обложек, источники трафика и дневная динамика — не подключены. Доступны агрегированные счётчики Data API.
- Загрузка видеофайлов не поддерживается.
- Автоматические субтитры помечаются как
asrи могут содержать ошибки распознавания. - Ответы, обновление видео, оценки и подписки видны публично или меняют состояние аккаунта. Агент должен показать точное действие до выполнения.
update_videoзаменяет весь блок описания видео. Promto сохраняет текущие поля, если они не переданы, но всё равно проверяйте итоговый заголовок, описание и теги.- Пользователь с ролью Viewer в YouTube Studio не может выполнять изменяющие действия.
Если что-то не работает
Кнопка подключения недоступна. Интеграция OAuth не настроена на сервере; обратитесь к администратору.
Google отменил вход. Повторите подключение и выберите аккаунт с нужным каналом.
Подключение истекло через семь дней. Пройдите вход ещё раз. Это ограничение текущего состояния проверки OAuth-приложения Google.
Агент не может ответить или изменить видео. Проверьте роль подключённого аккаунта в YouTube Studio; одного права просмотра недостаточно.
Субтитры недоступны. У ролика может не быть доступной дорожки либо подключённому аккаунту не выдано право её скачать.
Квота исчерпана. Дождитесь обновления дневного лимита и используйте чтение уже найденных видео вместо повторного поиска.