添加地理過濾

在本主題中,您將學習如何使用 CMS API 管理視訊的地理限制屬性。的CMS API允許您向視頻添加地理過濾屬性,以提供可以(或不能)觀看的國家/地區列表。

簡介

最初使用POST請求或使用PATCH請求創建視頻以更新視頻元數據時,可以添加地理過濾屬性。看到使用更新視頻CMS API有關更新請求的示例。

授權

您需要獲得權限才能更新視頻元數據的操作是video-cloud/video/update要么video-cloud/video/all

語法

geo是具有三個屬性的對象:

屬性 類型 必填 評論
geo.countries 國家代碼字串陣列 一個ISO 3166 2字母代碼清單小寫適用於將其列入白名單或黑名單以觀看視頻的國家/地區
geo.exclude_countries 布林值 如果true,正在觀看允許在geo.countries清單如果false,正在觀看只要在那些國家允許。
geo.restricted 布林值 如果true為視頻啟用了地理過濾

請求

    https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_ID}

要求主體:

請求主體將是一個JSON對象,其中包含要包含或不包含的國家/地區縮寫的數組:

    {"geo" : {
        "restricted" : true,
        "exclude_countries" : false,
        "countries" : ["ph","in","my","ja"]
      }
    }