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에 액세스하는 데 사용할 수 있는 전체 범위 목록이 포함되어 있습니다.