지리적 필터링 추가

이 항목에서는 다음을 사용하여 동영상의 지리적 제한 속성을 관리하는 방법에 대해 알아 봅니다. CMS API. 그만큼 CMS API 동영상에 지리적 필터링 속성을 추가하여 볼 수있는 (또는 표시 할 수없는) 국가 목록을 제공 할 수 있습니다.

소개

지리적 필터링 등록 정보는 처음 POST 요청을 사용하여 비디오를 만들거나 PATCH 요청을 사용하여 비디오 메타 데이터를 업데이트 할 때 추가 할 수 있습니다. 만나다 를 사용하여 비디오 업데이트 CMS API 업데이트 요청의 예입니다.

동영상 수준에서 지역 필터링을 적용하는 대신 또는 추가하여 지역 필터링을 적용 할 수 있습니다. 지리 정보 필터링을 적용 Brightcove player정책 키를 통한. Video Cloud 비디오와 player 지리 필터링 정책에 따라 두 가지 모두 적용됩니다. 국가 중 어느 하나의 정책으로 국가를 제외하면 해당 국가에서 비디오를 사용할 수 없습니다.

국가 코드를 입력해야합니다. 소문자.

일부 게시자는 미국뿐만 아니라 미군 기지에 동영상을 지역 필터링 할 수있는 기능을 요청했습니다. 이를 지원하기 위해 미국의 군사 선택권. 군대를 식별하는 100 % 신뢰할 수있는 방법은 없지만 .mil 도메인으로 확인되고 미국에 있지 않은 IP는 실제 국가가 아닌 미군 기지에서 오는 것으로 확인됩니다 원산지. 미국에있는 .mil 주소는 여전히 "us"로 식별됩니다.

지리 정보 필터링에 대한 액세스

권한 부여

비디오 메타 데이터를 업데이트하기 위해 필요한 권한은 다음과 같습니다. video-cloud/video/update or video-cloud/video/all.

통사론

geo 세 가지 속성을 가진 객체입니다.

비즈니스 재산	거래증명방식	필수	코멘트
`geo.countries`	국가 코드 문자열 배열	아니	An ISO 3166 2 문자 코드 목록 소문자로 동영상을보기위한 허용 목록에 있거나 블랙리스트에 올리려는 국가의 경우
`geo.exclude_countries`	부울	아니	If `true`,보기는 지원 에 포함 된 국가에서 허용 `geo.countries` 명부; 만약 `false`,보기는 만 해당 국가에서 허용됩니다.
`geo.restricted`	부울	아니	If `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"]
      }
    }