Отложенная публикация на YouTube через API: видео приватно до publishAt и как это показать

Ситуация и цель

YouTube — единственная из наших сетей, у которой есть собственное расписание. В остальных пост появляется, когда его отправляет планировщик. На YouTube сервис может загрузить видео сейчас, приватным, со временем в status.publishAt, и YouTube сам откроет его в этот момент. Правила описаны в справке по ресурсу Videos: время принимается, только пока видео приватно, а время в прошлом публикует видео сразу.

Мы начали так работать 15 октября 2026 года на канале с турами по карте World Checklist и с 22 октября — на научном канале Measured Earth: длинные видео по 8–16 минут и сотни мегабайт, каждое должно открываться в 14:00 UTC. Причина практическая. Файл на 455 МБ загружался 272 секунды, на YouTube видео появилось примерно через 520 секунд после создания поста, а обработка в HD идёт уже потом. Загрузка за день до публикации позволяет проверить обложку, обработку, плейлист и конечные заставки, пока видео никто не видит.

Что сделали, по шагам

1. Первый тест (15 октября). Тур по карте о McDonald’s ушёл через API Mellow Hub с privacyStatus: "private" и publishAt на 16 октября, 14:00 UTC; Hub передаёт поле провайдеру как есть. В тот же день по данным YouTube: обработано, HD, своя обложка, категория «Образование», 10 тегов. Открылось 16 октября в 14:00 UTC.
2. Положили в загрузку всё, что нужно YouTube. Две настройки роняют всю загрузку: переводы названий без основного языка видео (defaultLanguageNotSet) и теги длиннее 500 символов вместе (invalidTags). Hub проверяет обе до отправки. Третья проваливается молча: свою обложку YouTube ставит только на подтверждённом канале, а отказ по обложке пост не роняет. С 15 октября Hub читает ошибку обложки от провайдера и пишет в посте, что обложку не приняли.
3. В YouTube Studio сделали то, чего нет в API-пути. Плейлисты и конечные заставки наш провайдер не передаёт, поэтому их ставили в Studio вручную. Закреплённые комментарии новому каналу ещё не были доступны, поэтому первый комментарий публиковали после открытия видео.
4. Поставили неделю вперёд. Пять видео World Checklist загрузили на 22–26 октября и пять выпусков Measured Earth на 22–26 октября — по одному в день в 14:00 UTC.

Что пошло не так: отложенное видео выглядело опубликованным

Для любого API загрузка — успех в ту секунду, когда YouTube принял файл. Провайдер сообщил об успехе, строка канала стала published, и все экраны Hub прочли это как «уже открыто». 21 октября агент, который ведёт World Checklist, сообщил: пять видео на 22–26 октября стоят в «Опубликованных» с датой загрузки, вкладка «Запланировано» пуста, а календарь показывает не тот день.

Новый статус мы не вводили: загрузка сделана, и Hub не может её отозвать. Вместо этого, пока видео приватно и его publishAt впереди, время публикации поста равно publishAt. Всё, что читает это время (календарь, порядок в библиотеке, publishedAt в API), начинает говорить правду, а после наступления момента те же строки читаются как опубликованные тогда, когда видео действительно открылось.

• В кабинете такой пост лежит во вкладке «Запланировано» с пометкой «Запланировано на YouTube», стоит в календаре в свой день, не попадает в «Последние публикации» и не показывает просмотров.
• Для агентов статус остаётся published, у поста есть goesPublicAt со временем, а MCP-инструмент post_results говорит «запланировано» с состоянием строки scheduled_on_youtube.
• Правки в YouTube Studio. Видео, открытое раньше срока, уже публично, а Hub всё ещё считает его запланированным, поэтому Hub раз в пять минут спрашивает YouTube о каждом отложенном видео (до пятидесяти видео за единицу квоты API) и снимает отложенность, как только видео стало публичным. Видео, перенесённое на позже, не видно: оно приватно в любом случае.

Результаты

• Все пять постов на продакшене переехали на свои publishAt в первую же минуту после выкладки исправления 21 октября 2026 года.
• Два из пяти к тому времени уже перенесли в Studio на более ранние даты — 22 и 23 октября. Снятие отложенности у видео, открытого раньше, было покрыто тестами, но вживую ещё не наблюдалось, когда мы фиксировали исправление; вкладку «Запланировано» в кабинете владельца тоже проверили только тестами.
• Видео World Checklist на 22–26 октября открылись именно так, по одному в день, а выпуски научного канала выходили ежедневно с 22 октября.

Что не сработало и где границы

• Ни переноса, ни отмены из Hub. 22 октября основатель попросил, чтобы видео научного канала начали выходить в тот же день. Hub не может перенести видео, которое уже держит YouTube, поэтому расписание меняли в YouTube Studio: параметры доступа, затем «Запланировать», затем дата.
• Изменённое видео — это новая загрузка. 24 октября у двух научных выпусков переделали начало. Их загрузили новыми видео с тем же publishAt, а старые загрузки в Studio сделали приватными без расписания. Удалять их — решение человека.
• Десять минут «публикуется». Загрузка на 321 МБ около десяти минут числилась в Hub как «публикуется», хотя видео уже было в списке Studio и обрабатывалось.
• Удалить из Hub нельзя. Приватную тестовую копию самого первого видео пришлось удалять в Studio.
• Молчаливые обложки. До 15 октября отказ по обложке не оставлял в Hub никакого следа.

Как повторить

1. Загружайте с privacyStatus: "private" и publishAt во времени ISO 8601 в UTC. У публичной или доступной по ссылке загрузки YouTube время игнорирует.
2. Если передаёте переводы названий, укажите основной язык видео; держите теги в пределах 500 символов вместе.
3. Подтвердите канал, прежде чем рассчитывать на свои обложки, и проверьте обложку в Studio после загрузки.
4. Длинные видео загружайте хотя бы за день и проверяйте в Studio обработку в HD, обложку, плейлист и конечные заставки.
5. В своих записях датируйте видео по publishAt, а не по загрузке.
6. Перенести — в Studio: оставьте видео приватным и измените расписание, по шагам из нашего ответа о планировании YouTube Shorts. Отозвать — сделайте приватным без расписания или удалите в Studio.
7. В Mellow Hub те же поля передаются в options.youtube через API или MCP, и пост виден как «Запланировано на YouTube» до своего времени. Пост, запланированный в редакторе Hub, работает иначе: Hub загружает его в выбранное вами время.

Цифры коротко