Публикация видео на 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 дней вперёд.
Код ошибки, когда Meta не может получить файл видео по URL из file_url.
Код ошибки для слишком маленького видеофайла; Meta просит файл большего размера.
Окно для scheduled_publish_time на ребре videos, отсчитываемое от момента публикации видео.
Диапазон processing_progress, доля выполненной обработки видео, выводится рядом с video_status.
Хост для загрузки видео по документации Meta Video API, где graph-video.facebook.com помечен как устаревший для этого.
Дескриптор файла, который возвращает загрузка; его передают в /{page-id}/videos как fbuploader_video_file_chunk, чтобы опубликовать видео.
Как опубликовать видео на Page?
Запросом POST /{page-id}/videos с токеном доступа Page. Файл попадает к Meta одним из двух способов: через file_url, то есть доступный URL видео, который Meta загружает сама, или через загрузку, когда приложение сначала отправляет байты. file_url нельзя совмещать с upload_phase, параметром пошаговой загрузки, поэтому запрос использует один из способов.
| file_url | Uploaded file | |
|---|---|---|
| Where the video is | At a URL Meta can reach | On your own system |
| On /{page-id}/videos | file_url | fbuploader_video_file_chunk with the upload's handle |
| Before publishing | Nothing: Meta fetches the file | An upload session, then the bytes |
| If it fails | Error 389 when Meta cannot fetch it | Resume 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.
Платформа, построенная на 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 является одним подключением.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на