Кросспостинг - API Video - Документация

Кросспостинг видео

В этом документе объясняется, как с помощью Video API опубликовать видео на нескольких Страницах, не загружая его на каждую отдельно. Например, если у вас есть родительская Страница с несколькими дочерними, вы можете загрузить и опубликовать видео на родительской Странице, а затем опубликовать на всех дочерних, не загружая его снова на каждую из них.

Чтобы сделать кросспостинг видео, у вас должна быть возможность выполнять задачу CREATE на соответствующих Страницах и вы должны разрешить публикацию видео на соответствующих Страницах. Вам потребуются ID видео и ID Страниц, на которых вы хотите его опубликовать, а также маркеры доступа к Страницам для Страницы исходной публикации видео и Страниц, на которых его нужно опубликовать.

С помощью API вы можете определить, возможен ли кросспостинг этого видео или оно уже было опубликовано кросспостингом, выяснить, как разрешить кросспостинг на всех Страницах, управляемых через ваш аккаунт Business Manager, и получить список всех Страниц, для которых вам доступен кросспостинг.

Информацию о кросспостинге видео Reels на Страницу Facebook соавтора см. в нашем руководстве по публикации Reels.

Ограничения

Если видео уже было опубликовано кросспостингом на вашей Странице, но у вас нет роли на Странице его исходной публикации, вы не сможете изменить разрешения для этого видео.

Шаг 1. Включите кросспостинг

Для публикации видео на нескольких Страницах необходимо включить его кросспостинг на них.

Вам понадобятся:

ID видео, которое вы хотите опубликовать кросспостингом;
ID Страниц, на которых вы хотите опубликовать видео;
маркер доступа к Странице изначальной публикации видео;
разрешение publish_video;
разрешение pages_manage_posts;
разрешение pages_read_engagement.

Отправьте запрос POST к конечной точке Video:

POST /{api-version}/{video-id}
  ?allow_crossposting_for_pages=[{page_id:{page-a-id},allow:true},{page_id:{page-b-id},allow:true}]
  &access_token={page-access-token}

Укажите следующие параметры:

Имя параметра	Значение
`allow_crossposting_for_pages`	JSON-массив ID Страниц, на которых вы хотите опубликовать видео. Установите для параметра `allow` значение `true`, чтобы разрешить публикацию, или `false`, чтобы запретить ее.
`access_token`	Маркер доступа к Странице изначальной публикации видео.

Пример запроса

curl -X POST \
  "https://graph.facebook.com/v7.0/2918040388250909" \
  -F "allow_crossposting_for_pages=[{page_id:104371193424796,allow:true},{page_id:115969103185286",allow:true}] \
  -F "access_token=EAABkW..."

Пример ответа

{
  "success": true
}

Шаг 2. Выполните кросспостинг видео

Вам понадобятся:

ID видео, которое вы хотите опубликовать кросспостингом;
ID Страницы, на которой вы хотите опубликовать видео;
маркер доступа к Странице, на которой вы хотите опубликовать видео;
разрешение publish_video;
разрешение pages_manage_posts;
разрешение pages_read_engagement.

Отправьте запрос POST к конечной точке Page Videos:

POST /{api-version}/{page-id}/videos
    ?crossposted_video_id={video-id}
    &access_token={page-access-token}

Укажите следующие параметры:

Имя параметра	Значение
`crossposted_video_id`	ID видео, кросспостинг которого вы выполняете.
`access_token`	Маркер доступа к Странице, на которой вы публикуете видео.

Пример запроса

curl -X POST \
  "https://graph.facebook.com/104371193424796/videos?crossposted_video_id=2918040388250909&access_token=EAABk..."

Пример ответа JSON

{
  "id":"577600939847873"
}

Определение допустимости кросспостинга видео

Чтобы определить, возможен ли кросспостинг конкретного видео, отправьте к конечной точке Video запрос GET, добавив в него поле is_crossposting_eligible.

Вам понадобятся:

ID видео, которое вы хотите опубликовать кросспостингом;
маркер доступа к Странице изначальной публикации видео;
разрешение pages_manage_posts;
разрешение pages_read_engagement.

GET /{api-version}/{video-id}
   ?fields=is_crossposting_eligible
   &access_token={page-access-token}

Пример запроса

curl -X GET \
  "https://graph.facebook.com/v7.0/2918040388250909" \
  -F "is_crossposting_eligible" \
  -F "access_token=EAABkW..."

Пример ответа

{
  "is_crossposting_eligible": true,
  "id": "2918040388250909"
}

Имя параметра	Значение
`is_crossposting_eligible`	Показывает, возможен ли кросспостинг этого видео.
`access_token`	Маркер доступа к Странице изначальной публикации видео.

Определение статуса кросспостинга видео

Чтобы определить, было ли видео опубликовано кросспостингом, отправьте к конечной точке Video запрос GET, добавив в него поле is_crosspost_video.

Вам понадобятся:

ID видео, которое вы хотите проверить;
маркер доступа к Странице изначальной публикации видео;
разрешение publish_video;
разрешение pages_manage_posts;
разрешение pages_read_engagement.

GET /{api-version}/{video-id}
  ?fields=is_crosspost_video
  &access_token={page-access-token}

Укажите следующие параметры:

Имя параметра	Значение
`is_crosspost_video`	Показывает, является ли видео оригинальным или оно было опубликовано кросспостингом.
`access_token`	Маркер доступа к Странице изначальной публикации видео.

Пример запроса

curl -X GET \
 "https://graph.facebook.com/v7.0/577600939847873?fields=is_crosspost_video&access_token=EAABk..."

Пример ответа

{
  "is_crosspost_video": true,
  "id": "577600939847873"
}

Получение списка Страниц, для которых возможен кросспостинг

Вам понадобятся:

ID Страницы изначальной публикации видео;
маркер доступа к Странице изначальной публикации видео;
разрешение pages_manage_posts;
разрешение pages_read_engagement.

Отправьте запрос GET к конечной точке CrosspostWhitelistedPages Страницы.

GET {page-id}/crosspost_whitelisted_pages
  &access_token={page-access-token}

Пример запроса

curl -X GET \ "https://graph.facebook.com/v7.0/2918040388250909/crosspost_whitelisted_pages&access_token=EAABk..."

Пример ответа

{
  "crosspost_whitelisted_pages": {
    "data": [
      {
        "name": "Obsession, by Margaret",
        "id": "115969103185286"
      },
      {
        "name": "Cisco Dog",
        "id": "422575694827569"
      }
    ],
    "paging": {
      "cursors": {
        "before": "QVFIUn...",
        "after": "QVFIUk4..."
      }
    }
  },
  "id": "1353269864728879"
}

Включение кросспостинга для всех Страниц в своем аккаунте Business Manager

Чтобы разрешить кросспостинг на всех Страницах, управляемых через ваш аккаунт Business Manager, отправьте запрос POST к конечной точке Video.

Вам понадобятся:

ID видео, которое вы хотите опубликовать кросспостингом;
маркер доступа к Странице изначальной публикации видео;
разрешение pages_manage_posts;
разрешение pages_read_engagement.

POST /{api-version}/{video-id}
  ?allow_bm_crossposting=true
  &access_token={page-access-token}

Укажите следующие параметры:

Имя параметра	Значение
`allow_bm_crossposting`	Установите для параметра `allow` значение true, чтобы разрешить публикацию, или false, чтобы запретить ее.
`access_token`	Маркер доступа к Странице изначальной публикации видео.

Пример запроса

curl -X POST \
  "https://graph.facebook.com/v7.0/2918040388250909?allow_bm_crossposting=true&access_token=EAABkW..."

Пример ответа

{
  "success": true
}

Статистика

У каждого опубликованного кросспостингом видео есть собственный уникальный идентификатор video_id. Вы можете посмотреть статистику по видео для каждого видео и каждой Страницы.

Дополнительная информация

Дополнительную информацию о кросспостинге см. в нашем Справочном центре.