CMS API를 사용하여 성적표 관리

이 항목에서는 CMS API를 사용하여 동영상의 스크립트를 업데이트하는 방법을 배웁니다.

서문

PATCH요청을 사용하여 트랜스크립트와 관련된 메타데이터를 업데이트할 수 있습니다.

참고 사항

  • 이 문서에서 설명하는 방법은 비디오에 추가된 스크립트 파일을 업데이트하기 위한 것입니다. 현재 Brightcove가 수집 중에 스크립트 파일(캡션과 함께)을 생성하도록 할 수 있습니다. 자신의 성적표 파일 수집은 향후 릴리스에서 지원될 예정입니다.

권한

CMS API에 대한 요청에는 액세스 토큰이 포함된 인증 헤더가 필요합니다. 클라이언트 자격 증명을 얻고 이를 사용하여 액세스 토큰을 검색하는 방법에 대한 자세한 내용은 Brightcove OAuth 개요를 참조하십시오 .

비디오 메타데이터를 업데이트하는 데 필요한 작업은video-cloud/video/update또는video-cloud/video/all입니다.

구문

전체 어레이를 얻으려면 먼저 다음 요청을 하는 것이 좋습니다.


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

성적 증명서 업데이트

Transcripts를 업데이트할 때 Transcripts Fields 의 일부 필드는 유형에 따라 다르게 처리될 수 있습니다.

텍스트 트랙 필드
필드 유형 설명
id 문자열 읽기 전용 값. 업데이트해야 하는 TT를 식별하는 데 필요한 시스템 생성 ID입니다.
account_id 스트링 읽기 전용 값. 이 필드에 대한 업데이트는 무시됩니다.
src 스트링 읽기 전용. 성적표 파일의 위치입니다.
srclang 스트링 2자 또는 4자 언어 코드 (예: es또는es-MX
label 스트링 사람이 읽을 수 있는 라벨. 255자로 제한됩니다.
status 열거형 유효한 값(대소문자 구분):
  • published - 시청자는 스크립트를 볼 수 있습니다
  • draft - 시청자는 스크립트를 볼 수 없습니다.
sources 정렬 읽기 전용 값입니다. http및 트랜스크립트의https URL.
default 부울 true또는false . 서로 다른 성적표에는 여러default=true개를 추가할 수 없습니다srclang .

이 필드에 대한 업데이트는 무시됩니다.

요청

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

요청 본문 예

요청 본문은 성적표 배열을 포함하는 JSON 개체입니다.

"transcripts": [
  {
      "id": "d5967d03-1de1-a2de-47db-73486c7474c1",
      "account_id": "12345678910",
      "src": "https://bcboltqause1-a.akamaihd.net/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/d5967d03-1de1-47db-a2de-774c3486c741/transcript.txt?akamai_token=exp=1656544942~acl=/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/d5967d03-1de1-47db-a2de-774c3486c741/transcript.txt*~hmac=101a93fa0e0d247194de3c128460d457d4eea7a27d270a1f8509c2c00205af10",
      "srclang": "en-IE",
      "label": "Irish English",
      "status": "draft",
      "sources": [
          "https://bcboltqause1-a.akamaihd.net/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/d5967d03-1de1-47db-a2de-774c3486c741/transcript.txt?akamai_token=exp=1656544942~acl=/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/d5967d03-1de1-47db-a2de-774c3486c741/transcript.txt*~hmac=101a93fa0e0d247194de3c128460d457d4eea7a27d270a1f8509c2c00205af10",
          "https://bcboltqause1-a.akamaihd.net/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/d5967d03-1de1-47db-a2de-774c3486c741/transcript.txt?akamai_token=exp=1656544942~acl=/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/d5967d03-1de1-47db-a2de-774c3486c741/transcript.txt*~hmac=101a93fa0e0d247194de3c128460d457d4eea7a27d270a1f8509c2c00205af10"
      ],
      "default": false
  },
  {
      "id": "2d0cb632-8753-a68a-4143-aea0429eac7f",
      "account_id": "12345678910",
      "src": "https://bcboltqause1-a.akamaihd.net/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/2d0cb632-a68a-4143-8753-aea0429eac7f/transcript.txt?akamai_token=exp=1656544942~acl=/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/2d0cb632-a68a-4143-8753-aea0429eac7f/transcript.txt*~hmac=8ae7069ac9717559e9439f5112ee133d955ec18a09563e7a3e2a48a83637c108",
      "srclang": "en-US",
      "label": "American English",
      "status": "draft",
      "sources": [
          "https://bcboltqause1-a.akamaihd.net/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/2d0cb632-a68a-4143-8753-aea0429eac7f/transcript.txt?akamai_token=exp=1656544942~acl=/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/2d0cb632-a68a-4143-8753-aea0429eac7f/transcript.txt*~hmac=8ae7069ac9717559e9439f5112ee133d955ec18a09563e7a3e2a48a83637c108",
          "https://bcboltqause1-a.akamaihd.net/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/2d0cb632-a68a-4143-8753-aea0429eac7f/transcript.txt?akamai_token=exp=1656544942~acl=/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/2d0cb632-a68a-4143-8753-aea0429eac7f/transcript.txt*~hmac=8ae7069ac9717559e9439f5112ee133d955ec18a09563e7a3e2a48a83637c108"
      ],
      "default": false
  }
]