Captions

caption 리소스는 YouTube 자막 트랙을 나타냅니다. 자막 트랙은 정확히 하나의 YouTube 동영상에 연결됩니다.

메서드

API는 captions 리소스에 다음 메서드를 지원합니다.

list

지정된 동영상과 연결된 자막 트랙 목록을 검색합니다. API 응답에는 실제 자막이 포함되어 있지 않으며 captions.download 메서드는 자막 트랙을 검색하는 기능을 제공합니다. 지금 사용해 보세요.

insert

자막 트랙을 업로드합니다.

업데이트

자막 트랙을 업데이트합니다. 자막 트랙을 업데이트할 때 트랙의 초안 상태를 변경하거나, 트랙의 새 자막 파일을 업로드하거나, 두 가지 방법 모두 수행할 수 있습니다.

삭제

지정된 자막 트랙을 삭제합니다. 지금 사용해보기

download

자막 트랙을 다운로드합니다. 요청에 tfmt 매개변수 값이 지정되지 않은 경우 자막 트랙은 원래 형식으로 반환되고, 요청에 tlang 매개변수 값이 지정되지 않은 경우 원래 언어로 반환됩니다.

리소스 표현

다음 JSON 구조는 captions 리소스의 형식을 보여줍니다.

{
  "kind": "youtube#caption",
  "etag": etag,
  "id": string,
  "snippet": {
    "videoId": string,
    "lastUpdated": datetime,
    "trackKind": string,
    "language": string,
    "name": string,
    "audioTrackType": string,
    "isCC": boolean,
    "isLarge": boolean,
    "isEasyReader": boolean,
    "isDraft": boolean,
    "isAutoSynced": boolean,
    "status": string,
    "failureReason": string
  }
}

속성

다음 표는 이 리소스에 표시되는 속성을 정의합니다.