개요: 인제스트 프로파일 API

인제스트 프로파일 관리

컨텍스트 인식 인코딩 에 대해 Brightcove 계정을 활성화하거나 활성화하지 않을 수도 있습니다.

인제 스트 프로파일은 비디오를 업로드하거나 다시 트랜스 코딩 할 때 트랜스 코딩을위한 사양으로 사용됩니다. Ingest Profiles API를 사용하여 이러한 프로필을 관리 할 수 있습니다.

API 레퍼런스도 참조하십시오 .

용어 설명

프로필 JSON

아래의 "프로필 JSON"이라는 용어는 프로필 개체의 JSON 표현을 의미합니다. 여기에는 최상위 프로필 필드와 rendition 개체 모음이 목록으로 포함됩니다.

프로필 ID

A는 프로필의 최상위 필드일profile idid수도 있고 프로필의name최상위 필드일 수도 있습니다. 이 예에서는 (프로파일의 일부):

{
		"id": "f1b16093e2dc4f81810f1488",
		"version": 1,
		"name": "multi-platform-extended-static",
		"description": "Deliver high quality content for a wide range content types and screen sizes including mobile, desktop and large screens.", ...

"multi-platform-extended-static"또는 "f1b16093e2dc4f81810f1488"은 모두 유효한 프로필 ID입니다. 처음으로 프로필을 만들 때 이름은 있지만 ID는없는 프로필을 제공하고 응답에는 해당 ID를 포함하여 만든 프로필이 포함됩니다. 그런 다음 후속 API 호출에서 둘 중 하나를 사용할 수 있습니다.

참조 ID

는 프로필 내에서 렌디션을reference_id고유하게 식별합니다. 참조 ID는 DRM 패키징에 사용되며 향후 다른 용도로 사용될 수 있습니다. 프로파일 내에서 고유 한 것 외에도 참조 ID는 임의의 문자열이 될 수 있습니다. 공백을 포함해서는 안됩니다. 변환 형식을 쉽게 식별할 수 있는 몇 가지 구성표를 사용하는 것이 좋습니다 (예: mp4_1 , mp4_2hls1hls2 , 등).

프로필 버전

version A는 계정에 대한 프로파일의 개정 번호입니다. 긴 정수 값으로 표시됩니다. 참고: JSON 표현에서는 인용되지 않습니다.

활성 프로파일

프로필은 업로드에 사용할 수 있는active경우입니다. 예를 들어, 프로필을 업데이트하면 활성화 된 버전 번호가 증가 된 새 프로필이 생성되고 이전 버전은 비활성화됩니다.

표준 프로필

프로필은 Brightcove에서 사용하도록 제공한standard경우입니다 (즉, 단일 계정에만 적용되는 사용자 지정 프로필이 아님).

기본 프로필

프로필은default명시적으로 선택한 프로필이 없을 때 사용하는 경우를 말합니다. 계정 구성이 없거나 구성에서 기본 프로필을 설정하지 않은 경우 계정 유형에 따라 Brightcove standard프로필 중 하나가 사용됩니다.

기본 URL

서비스 URL은 다음과 같습니다.

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

권한

API에 대한 인증은 브라이트코브의 OAuth2 구현을 통해 이루어집니다. 계정에 대한 다음 작업에 대한 권한이있는 클라이언트 자격 증명 (클라이언트 ID 및 클라이언트 암호)이 필요합니다.

• video-cloud/ingest-profiles/profile/read
• video-cloud/ingest-profiles/profile/write
• video-cloud/ingest-profiles/account/read
• video-cloud/ingest-profiles/account/write

광고를 받으려면 OAuth UI로 이동하여 앱을 등록해야 합니다. client_idclient_secret

• API 인증 자격 증명 관리

CURL 또는 우편 배달부를 통해 자격 증명을 얻을 수도 있습니다.

• CURL을 사용하여 클라이언트 자격 증명 가져오기
• 우편 배달부를 사용하여 클라이언트 자격 증명 가져 오기

클라이언트 자격 증명을 사용하여 API를 호출 할 수있는 액세스 토큰을 얻습니다. 액세스 토큰은 권한 부여 헤더에 전달됩니다.

Authorization: Bearer {your_access_token}

참조 Oauth 섹션자세한 내용은.

최대 변환

인제스트 프로필 모범 사례를 참조하십시오 .

계정 운영

계정 수준에서 계정에 대한 모든 프로필을 가져 와서 새 프로필을 만들 수 있습니다.

끝점

/accounts/{account_id}/profiles

모든 프로필 가져 오기

계정의 모든 프로필 ( 표준 프로필 포함 ) 을 가져오려면 위에 표시된 엔드포인트에 GET 요청을 제출해야 합니다.

프로파일 작성

새 프로필을 생성하려면 요청 본문으로 프로필에 대한 JSON 데이터를 포함하여 위에 표시된 엔드 포인트에 POST 요청을 제출합니다. 세부 정보 및 샘플 요청 본문은 API참조를, 허용되는 필드는프로필 필드 참조를참조하십시오.

단일 프로필 작업

개별 프로필의 경우 이름 또는 ID로 프로필을 가져오고 프로필을 교체하고 프로필을 삭제할 수 있습니다.

끝점

/accounts/{account_id}/profiles/{profile_id}

을 위해profile_id , 당신이 사용할 수있는어느 하나그만큼:

• 이름 (예: 다중 플랫폼-표준-정적)
• 생성된 ID (예: f1b16093e2dc4f81810f1488)

아이디로 프로필 받기

단일 프로필을 검색하려면 위에 표시된 엔드 포인트에 GET 요청을합니다.

프로필 업데이트

프로필을 업데이트하려면 요청 본문에 프로필에 대한전체 JSON 데이터를 포함하여 위 엔드포인트에 PUT 요청을 보내십시오.

프로필 삭제

프로필을 삭제하려면 위의 엔드 포인트에 DELETE 요청을합니다.

/accounts/{account_id}/configuration

{
  "account_id": {account_id},
  "default_profile_id": {default_profile_id}
}

{
  "id": {configuration_id},
  "account_id": {account_id},
  "default_profile_id": {default_profile_id}
}

{
  "id": {configuration_id},
  "account_id": {account_id},
  "default_live_profile_id": {default_live_profile_id}
}

{
  "id": {configuration_id},
  "account_id": {account_id},
  "default_social_clipping_profile_id": {default_social_clipping_profile_id}
}

샘플 프로필

표준 프로필문서에는 모든 Video Cloud 계정에 현재 존재하는 모든 기본 프로필이 표시됩니다.

워터마크

비디오에 워터마크 (또는 로고 이미지) 를 추가하려면 Brightcove 지원에문의하십시오 .