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
API Google поддерживают несколько вариантов использования OAuth 2.0:
- Поток веб-приложений на стороне сервера поддерживает веб-приложения, которые могут безопасно хранить постоянную информацию.
- Поток веб-приложений JavaScript поддерживает приложения JavaScript, работающие в браузере.
- Поток приложений для мобильных и настольных компьютеров поддерживает приложения, установленные на устройстве, например телефоне или компьютере.
- Поток 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, мы рекомендуем вам определить области, для доступа к которым вашему приложению потребуется разрешение.
API YouTube Analytics использует следующие области действия:
Области применения | |
---|---|
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 Analytics для вашего контента YouTube. |
https://www.googleapis.com/auth/yt-analytics.readonly | Просмотр отчетов YouTube Analytics для вашего контента YouTube |
Области применения | |
---|---|
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 Analytics для вашего контента YouTube. |
https://www.googleapis.com/auth/yt-analytics.readonly | Просмотр отчетов YouTube Analytics для вашего контента YouTube |
Области применения | |
---|---|
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 Analytics для вашего контента YouTube. |
https://www.googleapis.com/auth/yt-analytics.readonly | Просмотр отчетов YouTube Analytics для вашего контента YouTube |
Области применения | |
---|---|
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 Analytics для вашего контента YouTube. |
https://www.googleapis.com/auth/yt-analytics.readonly | Просмотр отчетов YouTube Analytics для вашего контента YouTube |
API отчетов YouTube использует следующие области действия:
Области применения | |
---|---|
https://www.googleapis.com/auth/yt-analytics-monetary.readonly | Просматривайте денежные и неденежные отчеты YouTube Analytics для вашего контента YouTube. |
https://www.googleapis.com/auth/yt-analytics.readonly | Просмотр отчетов YouTube Analytics для вашего контента YouTube |
Области применения | |
---|---|
https://www.googleapis.com/auth/yt-analytics-monetary.readonly | Просматривайте денежные и неденежные отчеты YouTube Analytics для вашего контента YouTube. |
https://www.googleapis.com/auth/yt-analytics.readonly | Просмотр отчетов YouTube Analytics для вашего контента YouTube |
Области применения | |
---|---|
https://www.googleapis.com/auth/yt-analytics-monetary.readonly | Просмотр денежных и неденежных отчетов YouTube Analytics для вашего контента YouTube. |
https://www.googleapis.com/auth/yt-analytics.readonly | Просмотр отчетов YouTube Analytics для вашего контента YouTube |
Области применения | |
---|---|
https://www.googleapis.com/auth/yt-analytics-monetary.readonly | Просматривайте денежные и неденежные отчеты YouTube Analytics для вашего контента YouTube. |
https://www.googleapis.com/auth/yt-analytics.readonly | Просмотр отчетов YouTube Analytics для вашего контента YouTube |
Документ «Области API OAuth 2.0» содержит полный список областей, которые вы можете использовать для доступа к API Google.