Implementar la autorización de OAuth 2.0

YouTube Reporting API y YouTube Analytics API admiten el protocolo OAuth 2.0 para autorizar el acceso a los datos privados del usuario. En la siguiente lista, se explican algunos conceptos principales de OAuth 2.0:

  • Cuando un usuario intenta usar funciones de tu aplicación que requieren que haya accedido a un Google Account or YouTube account por primera vez, tu aplicación inicia el proceso de autorización de OAuth 2.0.

  • La aplicación dirige al usuario al servidor de autorización de Google. El vínculo a esa página especifica el scope de acceso que solicita tu aplicación para la cuenta del usuario. scope especifica los recursos que tu aplicación puede recuperar, insertar, actualizar o borrar cuando actúa como el usuario autenticado.

  • Si el usuario da su consentimiento y autoriza a la aplicación a acceder a esos recursos, Google genera un token para la aplicación. Dependiendo del tipo de aplicación, puede validar el token o cambiarlo por uno de otro tipo.

    Por ejemplo, una aplicación web del servidor cambia el token que se generó por un token de acceso y otro de actualización. El token de acceso permite a la aplicación autorizar solicitudes en nombre del usuario, mientras que el token de actualización permite a la aplicación obtener un nuevo token de acceso cuando el original expire.

Importante: Para utilizar la autorización de OAuth 2.0, debes obtener credenciales de autorización en la Consola de APIs de Google.

Para obtener más información, consulta la Guía de autorización de OAuth 2.0.

Flujos de OAuth 2.0

Las API de Google admiten varios casos de uso de OAuth 2.0:

  • El flujo de apps web del servidor admite aplicaciones web que pueden almacenar información persistente de forma segura.
  • El flujo de apps web de JavaScript admite aplicaciones de JavaScript que se ejecutan en un navegador.
  • El flujo de aplicaciones para dispositivos móviles y de escritorio admite aplicaciones instaladas en un dispositivo, como un teléfono o una computadora.
  • El flujo de OAuth 2.0 para TV y dispositivos de entrada limitada es compatible con dispositivos con capacidades de entrada limitadas, como consolas de juegos y cámaras de video. The YouTube Reporting and YouTube Analytics APIs do not currently support the OAuth 2.0 flow for devices.
  • El flujo de OAuth 2.0 para el flujo de cuentas de servicio admite interacciones servidor a servidor que no tienen acceso a la información del usuario. Sin embargo, YouTube Reporting API y YouTube Analytics API no admiten este flujo. 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.

Identifica los permisos de acceso

Los permisos permiten que tu aplicación solo solicite acceso a los recursos que necesita y, al mismo tiempo, permiten que los usuarios controlen la cantidad de acceso que le otorgan a tu aplicación. Por lo tanto, puede existir una relación inversa entre la cantidad de permisos solicitados y la probabilidad de obtener el consentimiento del usuario.

Antes de que comiences a implementar la autorización de OAuth 2.0, te recomendamos que identifiques los permisos a los que necesitará tu app para acceder.

La API de YouTube Analytics utiliza los siguientes alcances:

Permisos
https://www.googleapis.com/auth/youtubeAdministrar tu cuenta de YouTube
https://www.googleapis.com/auth/youtube.readonlyPermite ver tu cuenta de YouTube.
https://www.googleapis.com/auth/youtubepartnerVer y administrar sus elementos y el contenido asociado en YouTube
https://www.googleapis.com/auth/yt-analytics-monetary.readonlyPermite ver los informes monetarios y no monetarios de YouTube Analytics relacionados con tu contenido de YouTube
https://www.googleapis.com/auth/yt-analytics.readonlyVer informes de YouTube Analytics sobre su contenido de YouTube

La API de YouTube Reporting usa los siguientes permisos:

Permisos
https://www.googleapis.com/auth/yt-analytics-monetary.readonlyPermite ver los informes monetarios y no monetarios de YouTube Analytics relacionados con tu contenido de YouTube
https://www.googleapis.com/auth/yt-analytics.readonlyVer informes de YouTube Analytics sobre su contenido de YouTube

El documento Alcances de la API de OAuth 2.0 contiene una lista completa de los permisos que puedes usar para acceder a las APIs de Google.