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 흐름

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/youtube	YouTube 계정 관리
https://www.googleapis.com/auth/youtube.readonly	YouTube 계정보기
https://www.googleapis.com/auth/youtubepartner	YouTube에서 저작물 및 관련 콘텐츠를보고 관리합니다.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly	YouTube 콘텐츠에 대한 금전적 및 비 금전적 YouTube 분석 보고서보기
https://www.googleapis.com/auth/yt-analytics.readonly	YouTube 콘텐츠에 대한 YouTube 분석 보고서보기

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

범위
https://www.googleapis.com/auth/yt-analytics-monetary.readonly	YouTube 콘텐츠에 대한 금전적 및 비 금전적 YouTube 분석 보고서를 봅니다.
https://www.googleapis.com/auth/yt-analytics.readonly	YouTube 콘텐츠에 대한 YouTube 분석 보고서보기

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