透過媒體分享進行動態內嵌

要共享使用 Dynamic Ingest 創建的視頻，CMS API用來。共享帳戶必須啟用媒體共享-請聯繫Brightcove支持以進行驗證。視頻分享CMS API可以在轉碼完成之前提出請求。

簡介

本指南的“動態提取”部分與其他文檔和样本中討論的過程沒有什麼不同，也可以使用Studio中的“上傳”模塊來提取視頻。但是，為了完整性，捲曲這裡給出了所有三個步驟的示例：

建立影片
創建提取請求
使用CMS API共享視頻

驗證

本主題中描述的所有請求都需要通過Brightcove OAuth 系統 .

建立影片

視頻雲系統中的視頻對像是使用內容管理系統接口 .這是一個curl示例：

    curl --request POST \
      --url https://ingest.api.brightcove.com/v1/accounts/MASTER_ACCOUNT_ID/videos \
      --header 'authorization: Bearer OAUTH_TOKEN' \
      --header 'content-type: application/json' \
      --data '{"name": "Video to be shared"}'

返回的JSON將包含新的視頻ID：

    {
      "id": "VIDEO_ID",
      "account_id": "ACCOUNT_ID",
      ...
    }

創建提取請求

然後可以使用動態攝取 API使用從返回的視頻 ID CMS API要求。這是請求的curl示例：

    curl --request POST \
      --url https://ingest.api.brightcove.com/v1/accounts/MASTER_ACCOUNT_ID/videos/VIDEO_ID/ingest-requests \
      --header 'authorization: Bearer OAUTH_TOKEN' \
      --header 'content-type: application/json' \
      --data '{"master": {"url": "https://example.com/video.mp4"}}'

使用CMS API共享視頻

提取視頻後，您可以使用內容管理系統接口 .

請注意，在您可以與其他帳戶共享視頻之前，您必須先設置共享關係 - 請參閱使用 CMS API 進行媒體共享更多細節。

這是請求的curl示例：

    curl --request POST \
    --url 'https://cms.api.brightcove.com/v1/accounts/MASTER_ACCOUNT_ID/videos/VIDEO_ID/shares?=' \
    --header 'authorization: Bearer ACCESS_TOKEN' \
    --header 'content-type: application/json' \
    --data '[
      {
        "id":"AFFILIATE_ACCOUNT_ID"
      }
    ]'

響應包括共享帳戶中新視頻的ID：

    [ {
      "video_id" : "5555086013001",
      "affiliate_id" : "1752604059001",
      "affiliate_video_id" : null,
      "status" : "PROCESSING",
      "shared_at" : "2017-09-01T12:04:39.911Z",
      "updated_at" : "2017-09-01T12:04:39.911Z"
    } ]