ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

Публикация видео на Facebook Page через API

Видео попадает на Facebook Page через POST /{page-id}/videos: либо с file_url, то есть ссылкой, которую Meta загружает сама, либо с файлом, который приложение сначала передаёт в Meta. Поле title называет видео, а description содержит текст, который Meta может показать вместе с публикацией. Затем Meta обрабатывает файл, и GET /{video-id}?fields=status показывает video_status со значением processing, пока не появится ready.

easyCoexistence публикует видео в Facebook Page инструментом publish_facebook_post из Claude, ChatGPT или вашего кода, сразу или с отложенной публикацией до 90 дней вперёд.

389

Код ошибки, когда Meta не может получить файл видео по URL из file_url.

382

Код ошибки для слишком маленького видеофайла; Meta просит файл большего размера.

10 min to 6 months

Окно для scheduled_publish_time на ребре videos, отсчитываемое от момента публикации видео.

0 to 100

Диапазон processing_progress, доля выполненной обработки видео, выводится рядом с video_status.

graph.facebook.com

Хост для загрузки видео по документации Meta Video API, где graph-video.facebook.com помечен как устаревший для этого.

h

Дескриптор файла, который возвращает загрузка; его передают в /{page-id}/videos как fbuploader_video_file_chunk, чтобы опубликовать видео.

Как опубликовать видео на Page?

Запросом POST /{page-id}/videos с токеном доступа Page. Файл попадает к Meta одним из двух способов: через file_url, то есть доступный URL видео, который Meta загружает сама, или через загрузку, когда приложение сначала отправляет байты. file_url нельзя совмещать с upload_phase, параметром пошаговой загрузки, поэтому запрос использует один из способов.

file_urlUploaded file
Where the video isAt a URL Meta can reachOn your own system
On /{page-id}/videosfile_urlfbuploader_video_file_chunk with the upload's handle
Before publishingNothing: Meta fetches the fileAn upload session, then the bytes
If it failsError 389 when Meta cannot fetch itResume from the offset Meta reports

Как проходит загрузка файла, которого нет в сети?

В руководстве Meta по публикации видео используется Resumable Upload API. POST /{app-id}/uploads с file_name, file_length и file_type открывает сессию, а POST /upload:{session-id} с заголовком file_offset и байтами возвращает дескриптор h. Затем видео публикуется запросом POST /{page-id}/videos, где fbuploader_video_file_chunk равен этому дескриптору, а рядом указаны title и description. Эти вызовы загрузки используют токен доступа пользователя.

  • Прерванная загрузка продолжается с file_offset, который возвращает GET /upload:{session-id}.
  • Справочник videos также описывает пошаговую загрузку на том же ребре: upload_phase со значениями start, transfer и finish, с параметрами start_offset, file_size и video_file_chunk.

Что делают title и description?

Параметр title задаёт заголовок видео. description, по словам Meta, это текст, описывающий публикацию, который может показываться в истории о ней, поэтому сюда попадает текст публикации. Оба параметра необязательны для ребра videos, а publish_facebook_post передаёт свой message как description и оставляет title незаданным.

Как узнать, что видео готово?

Meta обрабатывает видео после получения. GET /{video-id}?fields=status возвращает video_status, который принимает значение processing, пока Meta работает, ready, когда видео загружено, закодировано и имеет миниатюры, или error, если обработка не удалась; processing_progress показывает долю выполненного от 0 до 100. Meta может также сообщать о статусе публикации через вебхуки Page по полю videos, на которое easyCoexistence не подписывается.

Какого размера и длины может быть видео?

Справочник Page videos и руководство Meta по публикации видео не задают ни максимального размера файла, ни длительности; правило размера, которое они называют, это ошибка 382 для слишком маленького файла. Руководства Meta по Reels и Stories задают собственные длительности: от 3 до 90 секунд для Reel и не более 60 секунд для видеоистории. Когда easyCoexistence планирует видео, он копирует файл в этот момент и отказывает в файле больше 1 ГБ.

Какие разрешения и задача Page нужны?

pages_manage_posts, pages_read_engagement и pages_show_list, с токеном Page от человека, который может выполнять задачу CREATE_CONTENT, по справочнику videos и руководству по публикации. Обзор Meta Video API формулирует строже: человек должен уметь выполнять на Page задачи, равные администраторским, или иметь роль администратора, назначенную через Business Manager.

Какие ошибки может вернуть публикация видео?

Справочник videos Meta перечисляет для POST /{page-id}/videos следующее:

  • 389: не удаётся получить файл видео по URL.
  • 382: файл видео слишком мал; повторите попытку с файлом большего размера.
  • 6000: проблема при загрузке файла видео; попробуйте другой файл.
  • 6001: проблема при загрузке видео; повторите попытку.
  • 368: действие сочтено злоупотреблением или иным образом запрещено.
  • 100: неверный параметр; 200: ошибка разрешений; 190: недействительный токен доступа OAuth 2.0.

Как publish_facebook_post публикует видео?

Инструмент принимает video_url, публичную ссылку HTTPS на файл, и message, и отправляет их на /{page-id}/videos как file_url и description, поэтому Meta сама загружает видео. Один пост содержит одно видео, а ссылка, отправленная рядом с ним, отклоняется, поэтому укажите URL в message. В поле post_id результата записан ID, который вернула Meta; для видео это собственный ID видео.

Как запланировать публикацию видео?

Передайте publish_facebook_post scheduled_at в формате ISO 8601 с часовым поясом, от 1 минуты до 90 дней вперёд. easyCoexistence копирует видео при планировании и публикует его на Page в это время; list_scheduled_posts показывает такие публикации, update_scheduled_post переносит её или меняет текст, а cancel_scheduled_post останавливает её. Собственный параметр Meta scheduled_publish_time на ребре videos допускает от 10 минут до 6 месяцев.

Распространённые ошибки

  • Указание в file_url на страницу, которая проигрывает видео, а не на сам файл. Meta загружает адрес сама, и адрес, который она не может получить, даёт ошибку 389.
  • Загрузка на graph-video.facebook.com. Обзор Meta Video API помечает этот хост как устаревший для загрузки видео и просит использовать graph.facebook.com.
  • Объявление видео до готовности. Проверяйте статус, пока video_status не станет ready, так как обработка продолжается и после того, как запрос публикации вернул ответ.
  • Отправка ссылки вместе с видео. publish_facebook_post отклоняет ссылку рядом с файлом; впишите URL в message.
Настройка с EasyCoexistence

Платформа, построенная на Partner API, делает то же запросом POST /channels/:id/posts. Стоимость: от US$ 9 за подключение в месяц, до US$ 0,75 по мере добавления подключений, первые 3 дня бесплатно.

Часто задаваемые вопросы

Можно ли загрузить видео с компьютера на Facebook Page через API?

Да, через Resumable Upload API Meta, который возвращает дескриптор для /{page-id}/videos, или через пошаговую загрузку на этом ребре. publish_facebook_post принимает публичный URL HTTPS, поэтому сначала разместите файл на хостинге.

Можно ли загрузить видео так, чтобы оно не появилось в ленте Page?

Да. published со значением false придерживает публикацию, no_story подавляет историю в ленте и хронологии, а secret оставляет видео вне Facebook и поиска.

Можно ли опубликовать одно видео на нескольких Page?

Да, через кросспостинг: опубликованное видео может выйти на других Page, которыми управляет человек, без повторной загрузки, и получит собственный ID видео на каждой Page.

Сколько стоит easyCoexistence для Facebook Page?

от US$ 9 до US$ 0,75 за подключение в месяц, в зависимости от общего числа подключений; первые 3 дня бесплатно. Каждая Page является одним подключением.

Читайте дальше

Facebook Reels API: публикация Reels на СтраницеКак Facebook Reels API публикует Reels на Странице: вызовы start, upload и finish на video_reels, требования Meta к видео, лимит 30 в сутки и статус.Публикация фото на Странице Facebook: один снимок и несколько фото в постеКак публиковать фото на Странице Facebook через Graph API: одно фото по URL или файлом, несколько в посте через attached_media и правила файлов Meta.Метрики видео и Reels Facebook через APIМетрики видео и Reels Facebook, которые работают в 2026 году: как читать их из video_insights и какие метрики показов Meta объявила устаревшими.Редактирование и удаление постов Страницы Facebook через APIКак изменить или удалить пост Страницы Facebook через Graph API: POST или DELETE по ID поста, правило одного приложения, разрешения и ошибки.API постов Facebook-страницы: текст, ссылки, фото и видеоКак публиковать посты на Facebook-страницах через Graph API: текст и ссылки в /feed, фото по URL в /photos, видео в /videos и правила Meta.Как запланировать посты страницы Facebook через Graph APIСобственное планирование Meta для постов страниц Facebook: published false и scheduled_publish_time, от 10 минут до 30 дней вперёд, проверка.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на