OAuth 2.0 승인 구현

YouTube Reporting API 및 YouTube Analytics API는 비공개 사용자 데이터에 대한 액세스를 승인하는 OAuth 2.0 프로토콜을 지원합니다. 다음 목록에서는 몇 가지 핵심 OAuth 2.0 개념을 설명합니다.

  • 사용자가 Google Account or YouTube account에 로그인해야 하는 애플리케이션의 기능을 처음 사용하려고 하면 애플리케이션에서 OAuth 2.0 승인 프로세스를 시작합니다.

  • 애플리케이션이 사용자를 Google 인증 서버로 안내합니다. 이 페이지로 연결되는 링크는 애플리케이션에서 사용자 계정에 요청하는 액세스의 scope를 지정합니다. scope는 애플리케이션이 인증된 사용자 역할을 할 때 가져오거나, 삽입하거나, 업데이트하거나, 삭제할 수 있는 리소스를 지정합니다.

  • 사용자가 애플리케이션에서 이러한 리소스에 액세스하도록 승인하는 데 동의하면 Google은 애플리케이션에 토큰을 반환합니다. 애플리케이션 유형에 따라 토큰을 검증하거나 다른 유형의 토큰으로 교환합니다.

    예를 들어 서버 측 웹 애플리케이션은 반환된 토큰을 액세스 토큰과 갱신 토큰으로 교환합니다. 액세스 토큰을 사용하면 애플리케이션이 사용자를 대신하여 요청을 인증할 수 있고, 갱신 토큰을 사용하면 기존의 액세스 토큰이 만료될 경우 애플리케이션이 새 액세스 토큰을 검색할 수 있습니다.

중요: OAuth 2.0 승인을 사용하려면 Google API 콘솔에서 승인 사용자 인증 정보를 가져와야 합니다.

자세한 내용은 OAuth 2.0 승인 가이드를 참고하세요.

OAuth 2.0 흐름

Google API는 다양한 OAuth 2.0 사용 사례를 지원합니다.

  • 서버 측 웹 앱 흐름은 영구 정보를 안전하게 저장할 수 있는 웹 애플리케이션을 지원합니다.
  • JavaScript 웹 앱 흐름은 브라우저에서 실행되는 JavaScript 애플리케이션을 지원합니다.
  • 모바일 및 데스크톱 앱 흐름은 휴대전화나 컴퓨터와 같은 기기에 설치된 애플리케이션을 지원합니다.
  • TV 및 제한된 입력 기기용 OAuth 2.0 흐름은 게임 콘솔 및 동영상 카메라와 같이 입력 기능이 제한된 기기를 지원합니다. The YouTube Reporting and YouTube Analytics APIs do not currently support the OAuth 2.0 flow for devices.
  • 서비스 계정 흐름의 OAuth 2.0 흐름은 사용자 정보에 액세스하지 않는 서버 간 상호작용을 지원합니다. 그러나 YouTube Reporting API 및 YouTube Analytics API는 이 흐름을 지원하지 않습니다. Since there is no way to link a Service Account to a YouTube account, attempts to authorize requests with this flow will generate an error.

액세스 범위 식별

범위를 사용 설정하면 애플리케이션이 필요한 리소스에 대한 액세스만 요청하는 동시에 사용자가 애플리케이션에 부여하는 액세스 양을 제어할 수 있습니다. 따라서 요청된 범위 수와 사용자 동의를 얻을 가능성 간에 반비례 관계가 있을 수 있습니다.

OAuth 2.0 승인을 구현하기 전에 앱에서 액세스하는 데 필요한 범위를 식별하는 것이 좋습니다.

YouTube Analytics API는 다음 범위를 사용합니다.

범위
https://www.googleapis.com/auth/youtubeYouTube 계정 관리
https://www.googleapis.com/auth/youtube.readonlyYouTube 계정 보기
https://www.googleapis.com/auth/youtubepartnerYouTube에서 내 자산과 관련 콘텐츠 조회 및 관리
https://www.googleapis.com/auth/yt-analytics-monetary.readonlyYouTube 콘텐츠에 관한 금전적 및 비금전적 YouTube 분석 보고서 보기
https://www.googleapis.com/auth/yt-analytics.readonlyYouTube 콘텐츠에 관한 YouTube 분석 보고서 보기

YouTube Reporting API는 다음 범위를 사용합니다.

범위
https://www.googleapis.com/auth/yt-analytics-monetary.readonlyYouTube 콘텐츠에 관한 금전적 및 비금전적 YouTube 분석 보고서 보기
https://www.googleapis.com/auth/yt-analytics.readonlyYouTube 콘텐츠에 관한 YouTube 분석 보고서 보기

OAuth 2.0 API 범위 문서에는 Google API에 액세스하는 데 사용할 수 있는 전체 범위 목록이 포함되어 있습니다.