구현: 자막

다음 예에서는 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 탐색기에서는 파일 다운로드 기능을 지원하지 않으므로 이 쿼리는 API 탐색기를 사용하여 테스트할 수 없습니다.

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

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

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

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

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

자막 트랙 업데이트

이 API는 자막 트랙의 초안 상태를 변경하거나, 파일의 새 자막 트랙을 업로드하거나, 둘 다를 지원합니다.

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

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

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

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

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

자막 트랙 삭제하기

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