Python으로 YouTube 스크립트 API: 5분 빠른 시작

요청 하나, 스크립트 하나

가장 짧은 방법은 Authorization 헤더에 키를 넣고 /v1/transcripts/{videoId}에 GET하는 것입니다. 응답은 JSON으로 영상 ID, 언어, 길이, 세그먼트 목록이 들어 있습니다. SDK는 필요 없고 requests나 httpx면 충분합니다.

언어와 형식 선택

다국어일 수 있는 영상은 먼저 /v1/transcripts/{videoId}/languages를 호출해 트랙을 고르고 ?lang=과 ?format=를 넘깁니다. srt나 vtt는 저장 가능한 자막을, json은 구조화 세그먼트를 유지합니다.

배치와 재시도

목록은 한 번에 최대 50개 ID를 /v1/transcripts에 POST하고 항목별 결과를 읽습니다. 타임아웃과 작은 지수 백오프를 넣으세요. 일시적 실패와 429는 금방 풀리고, 모든 응답에 기록용 X-Request-ID가 있습니다.

까다로운 경우 처리

자막이 없는 영상, 비공개, 지역 제한 영상이 있습니다. API는 타입이 있는 오류 코드와 읽을 수 있는 메시지를 주므로 산문이 아니라 코드로 분기합니다. request id를 기록하세요. 수정으로 가는 가장 빠른 길입니다.