YouTube Data API v2 지원 중단: 자주 묻는 질문

내 애플리케이션은 YouTube Data API v3에 없는 댓글, 자막 또는 기타 기능을 사용합니다. 어떻게 해야 하나요?

현재 댓글 및 동영상 자막 업로드에는 v2 API를 계속 사용할 수 있으며, 이 기능은 곧 v3 API에 추가될 예정입니다. 구체적인 날짜는 아직 정해지지 않았지만 개발자가 v3로 최대한 빨리 이전할 수 있도록 해당 기능을 출시할 예정입니다.

YouTube 전체가 계속 발전함에 따라 일부 다른 기능의 경우 v2 API와 v3 API 간에 100% 기능 패리티가 제공되지 않습니다. v3에서 지원되는 기능에 대한 자세한 내용은 v3 API 문서를 참고하세요.

v2에서는 ClientLogin을 통해 이메일 주소 + 비밀번호를 사용하여 인증할 수 있습니다. OAuth 2.0으로 전환하려면 어떻게 해야 하나요?

ClientLogin에서 OAuth 2.0으로 이전 가이드를 참고하세요.

v2와 v3의 할당량은 어떻게 다른가요? 무엇이 비슷한가요?

v2와 v3 모두 일부 작업 (예: 업로드)이 다른 작업 (예: 검색)보다 더 많은 할당량을 사용하는 비용 기반 할당량 시스템을 사용합니다.

v2와 v3 시스템의 가장 큰 차이점은 v3에서는 v2에서 제공하지 않는 전역 할당량 풀을 제공한다는 것입니다. v2에서는 단일 개발자 키로 요청이 이루어지지만 서로 다른 IP 주소 또는 서로 다른 인증된 사용자로부터 오는 경우 해당 개발자 키에 전역 할당량 오류가 발생할 수 없습니다. 최악의 경우 IP 주소 또는 YouTube 채널과 연결된 현지화된 할당량 오류가 발생합니다.

v3에는 전역 할당량 풀 (5천만 단위/일)이 있으며 개발자 콘솔에서 특정 프로젝트와 연결된 모든 API 호출은 이 풀에서 할당량을 감소시킵니다. 따라서 단일 IP 주소 또는 채널이 API 등록과 연결된 모든 할당량을 소비하여 다른 사용자에게 영향을 미치는 서비스 중단이 발생할 수 있습니다.

하지만 단일 사용자가 전역 할당량 풀을 소진하는 것을 방지할 수는 있습니다. 이 공개 문서에서는 사용자별로 더 엄격한 비율 제한을 정의하고 적용하는 방법을 설명합니다.

Data API v2는 동영상 검색과 같은 읽기 전용 쿼리에 대한 익명 API 액세스를 지원했습니다. v3에서 읽기 전용 호출을 하려면 왜 등록해야 하나요?

v3 API는 최신 Google API 인프라를 기반으로 빌드되며, 이 인프라에서는 다양한 API의 사용을 특정 개발자 콘솔 등록과 연결할 수 있습니다. 이를 통해 개발자는 사용 중인 Google 기술을 통합적으로 확인할 수 있습니다.

검색어와 같이 공개적으로 제공되는 데이터에만 액세스하는 API 호출의 경우 API 클라이언트는 API 요청 시 간단한 API 키를 지정할 수 있습니다. 비공개 사용자 데이터에 액세스하는 API 호출은 OAuth 2.0 토큰을 지정해야 합니다.

개발자는 Google Developers Console에서 간단한 API 키와 OAuth 2.0 토큰을 생성하는 데 필요한 사용자 인증 정보를 획득할 수 있습니다. 개발자는 API 탐색기를 사용하여 먼저 프로젝트를 만들지 않고도 API를 테스트할 수 있습니다.

v3으로 이전한 후 v2에서 사용한 것과 동일한 클라이언트 라이브러리를 계속 사용할 수 있나요?

v3 API는 v2와 근본적으로 다르며 사용할 수 있는 새로운 클라이언트 라이브러리 세트가 있습니다. 이러한 라이브러리는 모두 https://developers.google.com/youtube/v3/libraries에서 사용할 수 있으며 OAuth 2 승인을 위한 네이티브 지원이 포함되어 있습니다.

이전에 v2의 일부인 YouTube Insight API를 사용했습니다. 대안은 무엇인가요?

모든 개발자는 2013년 9월에 별도로 지원이 중단된 YouTube Insight API에서 새로운 YouTube Analytics API로 이전하는 것이 좋습니다.

YouTube 동영상의 RSS/Atom 피드에 GData API (v1 또는 v2)를 사용합니다. 지원 중단되면 대체할 수 있는 방법이 있나요?

현재 직접적인 대안은 없습니다. YouTube Data API v3의 subscriptions 서비스 메서드를 사용하여 애플리케이션 사용자가 YouTube 구독을 관리하고 검색할 수 있도록 하는 것이 좋습니다.

아직 v3에서 사용할 수 없는 v2 기능을 일부 사용하고 있으므로 동일한 애플리케이션에서 두 API 버전에 모두 액세스해야 합니다. 권장사항은 무엇인가요?

v3 클라이언트 라이브러리의 OAuth 2.0 지원을 사용하여 v2와 v3 모두에서 쓰기 작업에 사용할 수 있는 승인 토큰을 가져올 수 있습니다. https://gdata.youtube.com 또는 https://www.googleapis.com/auth/youtube 범위가 있는 토큰은 두 API 모두에서 작동합니다.

OAuth 2.0 토큰이 필요하지 않은 API 호출의 경우 https://cloud.google.com/console에서 v3 API 키를 가져와 v2와 v3 모두에 사용합니다.

일부 기능에 v2 API를 호출해야 하는 경우에도 가능하면 v3 API를 사용하도록 앱을 이전하는 것이 좋습니다. 이렇게 하면 앱에서 v3가 제공하는 더 강력한 기능을 사용할 수 있습니다. 또한 v3에서 지원되는 v2 전용 기능이 최종적으로 출시되면 향후 마이그레이션 작업도 간소화됩니다.