Для подготовки публикации через API выберите одну площадку и один формат. Сначала проверьте права аккаунта, видимость результата и способ избежать повторной отправки. Результат подготовки: план учебной загрузки, а не уже опубликованный материал.
API позволяет программе обращаться к сервису. Токен подтверждает доступ, но сам по себе не разрешает любой формат и любое действие.
Что выяснить до отправки
Запишите площадку, аккаунт, формат файла, название, описание и нужную видимость. Найдите официальный метод загрузки и его требования к авторизации. Секретные значения не вставляйте в копируемый промпт или журнал.
Для YouTube поле status.privacyStatus нужно задавать явно. Не полагайтесь на видимость по умолчанию. Например, для закрытой учебной загрузки план должен содержать private. Документация videos.insert.
У TikTok Direct Post публикации неаудированных клиентов ограничены закрытым просмотром. Это правило TikTok нельзя переносить на YouTube или Instagram. Требования Direct Post.
Как подготовить учебную загрузку
- Проверьте формат, размер, длительность и доступные режимы по документации выбранной площадки.
- Подготовьте короткий учебный файл без личных данных и таблицу ожидаемых свойств публикации.
- Опишите действия отдельно: создание объекта, загрузка, обработка, проверка состояния и выпуск для зрителей. Площадка может объединять или разделять эти шаги.
- Назначьте свой ID задания. Сохраняйте ID объекта площадки сразу после его получения.
- После отдельно разрешённой отправки проверьте состояние обработки и откройте результат обычным способом. Сверьте аккаунт, видимость, текст, обложку и звук.
- При повторе сначала ищите результат предыдущей попытки. Тайм-аут запроса не доказывает, что объект не создан.
Промпт для Codex
Подготовь план загрузки учебного материала через API: [площадка, аккаунт, формат].
Найди актуальную официальную документацию. Проверь доступы, ограничения файла и способ явно задать закрытую видимость.
Опиши сохранение ID задания и ID результата, проверку обработки и действия после тайм-аута без дубля.
Составь список настроек без значений токенов. Пока ничего не загружай, не отправляй и не меняй в аккаунте.
План наблюдения: Подготовить задачу к расписанию. Перед автоматизацией выполните проверку повторного запуска.
Если результат неизвестен
Проверьте состояние объекта по сохранённому ID и журналу. При недостатке прав сверяйте разрешения приложения и выбранный аккаунт. Прежде чем повторять запрос, выясните, можно ли однозначно отличить новую загрузку от прежней.
Для отмены остановите очередь. Уже созданная публикация скрывается или удаляется отдельным действием после проверки её ID. Остановка программы не удаляет результат на площадке.
Источники и границы проверки
Эта инструкция готовит тестовую загрузку, но не подключает аккаунт и не отправляет файл. Для Instagram конкретный способ отправки здесь не описан: перед настройкой прочитайте официальную документацию, проверьте тип аккаунта, разрешения и поддерживаемый формат.
