動画API

動画をクロス投稿する

このドキュメントでは、動画をページごとにアップロードするのではなく、動画APIを使用して複数のページに公開する方法について説明します。例えば、複数の子ページを持つ親ページがある場合、親ページに動画をアップロードして公開した後、すべての子ページにその動画を公開できます。ページごとに動画をアップロードする必要はありません。

動画をクロス投稿するには、ページでCREATEタスクを実行できることと、動画を特定のページに公開できるようにすることが必要です。動画のIDと動画を公開するページのIDに加えて、動画が最初に公開されたページと動画を公開するページのページアクセストークンが必要になります。

APIを使用して、ある動画がクロス投稿可能な動画か、またはすでにクロス投稿されている動画かを確認できます。また、ビジネスマネージャが管理するすべてのページへのクロス投稿を有効にすることも、クロス投稿可能なページのリストを取得することもできます。

リール公開ガイドで、コラボレーターのFacebookページへの動画のクロス投稿に関する情報をご覧ください。

制限

動画がページにすでにクロス投稿されていても、動画が最初に公開されたページに対する役割を自分が持っていない場合は、動画のアクセス許可を変更できません。

ステップ1. クロス投稿を有効にする

動画を複数のページに公開するには、それらのページへの動画のクロス投稿を有効にする必要があります。

以下が必要です。

動画エンドポイントにPOSTリクエストを送信します。

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

動画を公開するページIDのJSON配列。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. 動画をクロス投稿する

以下が必要です。

ページ動画エンドポイントにPOSTリクエストを送信します。

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"
}

クロス投稿可能な動画かどうかを確認する

ある動画がクロス投稿可能であるかどうかを確認するには、is_crossposting_eligibleフィールドを指定したGETリクエストをその動画のエンドポイントに送信します。

以下が必要です。

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

動画が最初に公開されたページのページアクセストークン。

動画のクロス投稿ステータスを取得する

ある動画がすでにクロス投稿されているかどうかを確認するには、is_crosspost_videoフィールドを指定したGETリクエストをその動画のエンドポイントに送信します。

以下が必要です。

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"
}

クロス投稿可能なページのリストを取得する

以下が必要です。

ページのCrosspostWhitelistedPagesエンドポイントにGETリクエストを送信します。

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"
}

すべてのビジネスマネージャページへのクロス投稿を有効にする

ビジネスマネージャが管理するすべてのページへのクロス投稿を有効にするには、その動画のエンドポイントにPOSTリクエストを送信します。

以下が必要です。

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があります。動画とページごとに動画のインサイトを確認できます。

参考情報

クロス投稿の詳細については、ヘルプセンターをご覧ください。