구현: 자막

다음 예는 YouTube Data API (v3)를 사용하여 자막과 관련된 기능을 실행하는 방법을 보여줍니다.

동영상의 자막 트랙 목록을 가져옵니다.

특정 동영상에 사용할 수 있는 자막 트랙 목록을 가져오려면 captions.list 메서드를 호출합니다. videoId 매개변수 값을 자막을 검색하는 동영상을 고유하게 식별하는 YouTube 동영상 ID로 설정합니다. OAuth 2.0을 사용하여 요청을 승인해야 합니다.

아래 요청은 Google 스토리 YouTube 채널의 동영상 자막 목록을 검색합니다.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.captions.list?
part=snippet
&videoId=PRU2ShMzQRg

코드 샘플은 captions.list 메서드 문서를 참고하세요.

자막 트랙 만들기

이 쿼리는 API 탐색기에서 파일 업로드 기능을 지원하지 않으므로 API 탐색기를 사용하여 테스트할 수 없습니다.

API의 captions.insert 메서드를 사용하여 동영상의 새 자막 트랙을 업로드할 수 있습니다. 트랙을 업로드할 때 다음 caption 리소스 속성의 값을 지정해야 합니다.

자막 트랙을 업로드할 때 다음 추가 옵션을 사용할 수 있습니다.

  • sync 매개변수를 true로 설정하면 YouTube가 업로드된 자막 파일에 있는 시간 코드를 무시하고 자막에 새 시간 코드를 생성합니다.

    시간 코드가 없는 스크립트를 업로드하는 경우 또는 파일의 시간 코드가 잘못된 것으로 판단되어 YouTube에서 수정하기를 원하는 경우 sync 매개변수를 true로 설정해야 합니다.

  • caption 리소스의 snippet.isDraft 속성을 true로 설정하면 트랙이 공개적으로 표시되지 않습니다.

코드 샘플은 captions.insert 메서드 문서를 참고하세요.

자막 트랙 다운로드

API Explorer에서 파일 다운로드 기능을 지원하지 않으므로 API Explorer를 사용하여 이 쿼리를 테스트할 수 없습니다.

특정 자막 트랙을 다운로드하려면 captions.download 메서드를 호출합니다. 다운로드 중인 자막 트랙을 고유하게 식별하는 YouTube 자막 트랙 ID에 id 매개변수 값을 설정합니다. OAuth 2.0을 사용하여 요청을 승인해야 합니다.

v3 API는 다음 옵션을 지원합니다.

  • 자막 트랙이 특정 형식으로 반환되도록 지정하려면 tfmt 매개변수 값을 설정하여 원하는 형식을 식별합니다. 매개변수 정의에 지원되는 값이 나열됩니다.

  • 자막 트랙의 번역을 검색하려면 tlang 매개변수 값을 원하는 자막 언어를 식별하는 ISO 639-1 두 자리 언어 코드로 설정하세요. 번역은 Google 번역과 같은 기계 번역을 사용하여 생성됩니다.

코드 샘플은 captions.download 메서드 문서를 참고하세요.

자막 트랙 업데이트

API는 자막 트랙의 초안 상태를 변경하거나 파일의 새 자막 트랙을 업로드하는 기능 또는 두 기능을 모두 사용할 수 있습니다.

API 탐색기를 사용하여 트랙의 초안 상태 변경 기능을 테스트할 수 있습니다. 하지만 도구는 파일 업로드를 지원하지 않으므로 API 탐색기를 사용하여 실제 자막 트랙을 업데이트할 수는 없습니다.

아래 요청은 Google 스토리 YouTube 채널의 동영상 자막 목록을 검색합니다.

이 요청은 자막 트랙의 초안 상태를 true로 업데이트합니다. 즉, 트랙이 공개적으로 표시되지 않습니다. API 탐색기에서 요청을 완료하려면 id 속성의 값을 설정하여 자막 트랙을 식별해야 합니다.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.captions.update?
part=snippet

코드 샘플은 captions.update 메서드 문서를 참고하세요.

자막 트랙 삭제

이 예에서는 자막 트랙을 삭제하는 방법을 보여줍니다. 이 예시의 단계는 다음과 같습니다.

  • 1단계: 자막 트랙 ID 검색하기

    위 단계에 따라 동영상의 자막 트랙 목록을 검색합니다. 이 목록은 각 트랙의 ID를 키로 사용하여 자막 트랙 목록을 표시하는 데 사용할 수 있습니다.

  • 2단계: 트랙 삭제하기

    captions.delete 메서드를 호출하여 특정 동영상을 삭제합니다. 요청에서 id 매개변수는 삭제하려는 트랙의 자막 트랙 ID를 지정합니다. 요청은 OAuth 2.0을 사용하여 승인되어야 합니다. API 탐색기에서 이 쿼리를 테스트하는 경우 id 매개변수 값을 유효한 자막 트랙 ID로 대체해야 합니다.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.captions.delete?
id=CAPTION_TRACK_ID