影片 API

多文發佈影片

本文件說明如何使用影片 API 在多個粉絲專頁上發佈影片，而不用上傳影片到各個粉絲專頁。例如，如果您有含多個附屬粉絲專頁的主要粉絲專頁，可以將影片上傳並發佈到主要粉絲專頁，然後將影片發佈到所有附屬粉絲專頁，如此便不用上傳影片到每個粉絲專頁。

若要多文發佈影片，您必須能在粉絲專頁上執行 CREATE 工作，並啟用讓影片能發佈到特定的粉絲專頁。您需要準備影片編號和要發佈影片之粉絲專頁的編號，以及原始發佈影片之粉絲專頁和要發佈之粉絲專頁的粉絲專頁存取權杖。

您可使用 API 判斷影片是否符合多文發佈或多文發佈影片的資格、如何啟用多文發佈至企業管理平台管理的所有粉絲專頁，以及取得可多文發佈的所有粉絲專頁清單。

請瀏覽我們的 Reels 發佈指南，瞭解多文發佈連續短片至協作者 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

要發佈影片之粉絲專頁編號的 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

要多文發佈之影片的影片編號。

access_token

要發佈影片之粉絲專頁的粉絲專頁存取權杖。

要求範例

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

JSON 回應範例

{
  "id":"577600939847873"
}

取得影片多文發佈資格

若要判斷影片是否符合多文發佈資格，請發送 GET 要求至含 is_crossposting_eligible 欄位的影片端點。

必備項目：

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

原始發佈影片之粉絲專頁的粉絲專頁存取權杖。

取得影片的多文發佈狀態

若要判斷影片是否為多文發佈影片，請發送 GET 要求至含 is_crosspost_video 欄位的影片端點。

必備項目：

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

取得符合多文發佈資格的粉絲專頁清單

必備項目：

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

啟用所有企業管理平台粉絲專頁的多文發佈

若要啟用企業管理平台管理之所有粉絲專頁的多文發佈，請發送 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。您可查看每個影片和粉絲專頁的影片洞察報告。

另請參閱

如需多文發佈的詳細資訊，請瀏覽我們的使用說明。