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

獲取影片多重發佈資格

要確定影片是否符合多重發佈資格，請使用 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。您可以查看每段影片和每個專頁的影片洞察報告。

另請參閱

有關多重發佈的詳細資訊，請瀏覽幫助中心。