지원 지원 문의 | 시스템 상태 시스템 상태
페이지 내용

    개요 : Policy API

    이 항목에서는 Policy API 이를 사용하고 사용하는 방법입니다. 그만큼 Policy API 정책 키를 만들거나 가져 오는 데 사용됩니다.
     

    소개

    그리고, 정책 키 귀하의 동영상 및 재생 목록 콘텐츠를 검색하는 데 사용됩니다. Video Cloud 라이브러리를 사용하여 Playback API.

    또한 API 참조.

    너 하나 필요해?

    자체 정책 키를 생성해야하는 특별한 경우 만 있습니다.

    • 정책 키가 생성됩니다. Brightcove Player만들 때 자동으로. 지역 필터링을 사용하여 키를 얻으려면이 API를 사용하여 정책 키를 직접 생성하면됩니다. player또는 Playback API 만들지 않고 player -일반적으로이 앱은 장치 SDK. 참조 정책 키 정책 키를 얻는 방법에 대한 지침은 Brightcove Player.
    • 동영상 검색 요청 수행 :
      • 당신은 검색 가능 정책 키.
      • 새로운 정책 키 생성 Brightcove Players는 기본적으로 검색을 사용할 수 없습니다. 이 설정은 Policy API.
      • 일반적으로 검색 가능 정책 키는 브라우저가 아닌 서버에만 저장해야합니다. player 재생 가능한 모든 동영상을 나열하는 데 사용할 수 있으므로 모바일 앱 또는 재생 가능한 모든 비디오를 검색 할 수있는 것이 마음에 들지 않으면 일부 계정의 경우 적용되지 않을 수 있습니다.
      • 검색 요청은 재생 가능한 비디오 만 반환합니다. API 요청 / 응답 세부 정보는 비디오 가져 오기 의 섹션 Playback API 참고.

    FAQ

    여기에 대한 몇 가지 질문이 있습니다. Policy API 우리가 일반적으로 얻는 것.

    정책 키는 여러 계정에 대해 만들 수 있습니까, 아니면 하나만 만들 수 있습니까?
    정책 키는 하나의 계정에 대한 동영상 및 재생 목록에 대한 액세스를 허용합니다. 계정이 여러 개인 경우 각각에 대해 정책 키를 만들어야합니다.
    정책 키가 만료됩니까?
    아니요, 정책 키는 영원히 좋습니다. 정책 키를 취소해야하는 경우에는 Brightcove 지원 - 요청에서 취소하려는 계정 아이디와 정책 키를 포함하십시오.
    정책 키는 계정의 모든 사용자에게 적용됩니까?
    예, 정책 키를 가진 사람은 누구나 사용할 수 있습니다.
    정책 키를 업데이트 할 수 있습니까?
    아니요, 정책 키를 업데이트 할 방법이 없습니다. 당신은 할 수 있습니다 정책 키를 얻는다. 기존에서 player 귀하의 Video Cloud 계정을 사용하거나 Policy API.

    기본 URL

    의 기본 URL Policy API 입니다

        https://policy.api.brightcove.com/v1

    계정 경로

    모든 경우에있어 요청은 특정 Video Cloud 계정. 그래서, 당신은 항상 /accounts/ 계정 ID가 기본 URL에 이어집니다.

        https://policy.api.brightcove.com/v1/accounts/{account_id}

    인증

    요청은에 전달 된 액세스 토큰에 의해 인증됩니다. Authorization 헤더:

        Authorization: Bearer {access_token}

    토큰에 액세스하려면 다음 단계를 따르십시오.

    1. 클라이언트 자격 증명 얻기 ( client_id client_secret )를 통해 비디오 클라우드 스튜디오 (권장).

      정책 키 생성 요청과 함께 사용할 수있는 액세스 토큰의 경우 클라이언트 자격 증명은 Studio에서 다음 권한을 가져야합니다. Player읽기 및 읽기 / 쓰기

      인증 권한
      인증 권한

      또한 클라이언트 자격 증명을 직접 얻을 수도 있습니다. Brightcove OAuth API.

    2. 클라이언트 자격 증명이 있으면 에서 임시 액세스 토큰을 얻는다. OAuth API.

    필수 헤더

    이외에도 Authorization 이전 섹션에서 설명한 헤더에는 요청에도 Content-Type 헤더:

        Content-Type: application/json

    정책 키 만들기

    새 정책 키를 작성하려면 다음에 대한 POST 요청을하십시오.

        https://policy.api.brightcove.com/v1/accounts/{account_id}/policy_keys

    본문 요청

    요청 본문에 정책에 JSON을 포함하십시오.

        {
          "key-data": {
            "account-id": "{account_id}"
          }
        }

    이는 계정에 대한 액세스를 제한하는 가장 기본적인 정책이므로 사용자가 만든 모든 정책에이를 포함시켜야합니다. 여기에있는 계정 ID는 요청 URL의 계정 ID와 일치해야하며 그렇지 않으면 오류가 반환됩니다.

    도메인 제한

    계정에 대한 액세스를 제한하는 것 외에도 특정 도메인에 대한 액세스를 allowed-domains 키 :

        {
          "key-data": {
            "account-id": "123456789001",
            "allowed-domains": [
              "http://www.abc.com",
              "https://www.abc.com",
              "http://www.xyz.com",
              "https://www.xyz.com"
            ]
          }
        }

    지리적 제한

    그리고, Policy API 에 대한 지역 필터링을 구현하는 데 사용할 수 있습니다 player 대신에 또는 이에 추가하여 개별 동영상.

    견본

    다음은 미국 및 미국 영토와 군사 기지에서만 재생할 수있는 허용 된 사이트 목록 정책 집합입니다.

        {"account-id": "8523232323",
          "geo": {
            "countries": ["us", "usmil", "pr", "gu", "vi", "as", "mp"],
            "exclude_countries": false
          }
        }

    대신 해당 국가를 차단하려면 exclude_countries 사실로.

    SSAI 필요

    서버 측 광고 삽입 (SSAI)을 사용하는 경우 API 요청에서 적절한 광고 구성을 시행 할 수 있습니다. 정책 키를 구성하여 ad_config_id 모든 URL 매개 변수로 추가됩니다. Playback API 요청.

    견본

    다음은 그 예입니다.

        {
          "key-data": {
            "account-id": "1752604059001",
            "require-ad-config": true
          }
        }

    사용 방법에 대한 자세한 내용은 ad_config_id 와 Playback API 요청은 Playback API 개요 : SSAI를 통한 동영상 요청 문서를 참조하시기 바랍니다.

    동영상 검색

    비디오 검색 요청을 수행 할 때는 검색이 가능한 정책 키를 사용해야합니다. 검색 가능한 정책 키를 만들려면 호출의 요청 본문에 다음이 포함되어야합니다.

        {
          "key-data": {
            "account-id": "57838016001",
            "apis": ["search"]
          }
        }

    API 응답

    정책 생성 요청에 대한 응답은 JSON으로 암호화 된 key-string 에 대한 요청을 인증하는 데 사용할 수 있습니다. Playback API, 키와 관련된 정책은 물론

        {
          "key-data": {
            "account-id": "57838016001"
          },
          "key-string": "BCpkADawqM0NK0Rq8n6sEQyWykemrqeSmIQqqVt3XBrdpl8TYlvqN3hwKphBJRnkPgx6WAbozCW_VgTOBCNf1AQRh8KnmXSXfveQalRc5-pyNlSod5XzP99If2U"
        }

    정책 요청

    관련 지을 수 있었던 정책 오브젝트를 취득하려면 key-string , GET 요청을하십시오 :

        /accounts/v1/{account_id}/policy_keys/{key_string}

    응답은 키 문자열과 정책에 대한 JSON 표현입니다.

        {
          "key-data": {
            "account-id": "57838016001"
          },
          "key-string": "BCpkADawqM0NK0Rq8n6sEQyWykemrqeSmIQqqVt3XBrdpl8TYlvqN3hwKphBJRnkPgx6WAbozCW_VgTOBCNf1AQRh8KnmXSXfveQalRc5-pyNlSod5XzP99If2U"
        }

    정책 취소

    기존 정책을 철회해야하는 경우 요청을 제출하십시오. Brightcove 지원. 요청에 취소하려는 정책의 키 문자열을 포함하십시오.


    페이지 최종 업데이트 28 Sep 2020