Desagregación del consentimiento en las APIs de Google Ads

Jueves, 20 de febrero de 2025

¿Cuáles son los cambios?
A partir de la semana del 1 de mayo de 2025, implementaremos la desagregación del consentimiento para la autenticación de usuarios de OAuth en todos los proyectos de Google Cloud que se crearon antes de 2019. Si eres propietario de una aplicación que utiliza una API relacionada con los anuncios a través de un proyecto de Google Cloud creado antes de 2019, es posible que debas actualizar tu aplicación para que controle el consentimiento del usuario desagregado antes del 1 de mayo de 2025.

Contexto
La desvinculación del consentimiento para el flujo de autenticación de usuarios de OAuth permite que los usuarios personalicen los permisos de OAuth específicos que quieren autorizar para tu aplicación, en lugar de un enfoque de todo o nada. Todos los proyectos de la consola de Google Cloud creados desde 2019 tienen esta función activada, mientras que todos los proyectos creados antes de 2019 la tienen desactivada.

¿A quiénes afecta este cambio?
Este cambio te afectará si se cumplen TODAS las condiciones que se indican a continuación:

  1. Tu aplicación de la API usa un proyecto de la consola de Google Cloud que se creó antes de 2019.
  2. Tu aplicación implementa el flujo de consentimiento del usuario de OAuth 2.0, un flujo de trabajo de autenticación en el que el usuario accede con su Cuenta de Google y otorga uno o más permisos que solicita tu aplicación.
  3. Tu aplicación usa más de una API de Google, y una de ellas es una API relacionada con los anuncios que se indica a continuación.

¿A quiénes no afecta este cambio?

  • Tokens de actualización existentes: Este cambio no afecta las autenticaciones de usuarios que ya tienes implementadas. Tus tokens de actualización existentes seguirán funcionando sin cambios ni necesidad de volver a autenticarte.
  • Aplicaciones de un solo permiso: Si tu aplicación usa solo un permiso de la API de Google, este cambio no la afectará, ya que no hay varios permisos de OAuth para desvincular.
  • Aplicaciones de un solo usuario o aplicaciones autenticadas manualmente: Tu aplicación no tiene implementado un flujo de autenticación de usuarios de OAuth explícito. En su lugar, usas una secuencia de comandos de autenticación manual, como GenerateUserCredentials, gcloud CLI o OAuth Playground, para autenticar al usuario y, luego, usas esas credenciales durante un período prolongado. Dado que seleccionas todos los permisos que requiere tu aplicación durante la autenticación, este cambio no la afecta.
  • Cuentas de servicio: Si tu aplicación usa una cuenta de servicio para autenticar tus llamadas a la API, este cambio no te afectará.

¿Qué tengo que hacer?
Debes asegurarte de que tu aplicación pueda controlar el consentimiento parcial del usuario. Para ello,

  1. Solicita la lista de permisos de OAuth a los que el usuario dio su consentimiento incluyendo el parámetro include_granted_scopes en tu flujo de OAuth.
  2. Examina la lista real de permisos de OAuth que el usuario aceptó en la respuesta de OAuth.
  3. Implementa la autorización incremental en tu aplicación.

Revisa nuestra guía de consentimiento detallado de OAuth para conocer los requisitos y las prácticas recomendadas para administrar el consentimiento detallado.

¿Cómo pruebo esta función?
Existen dos maneras de probar esta función:

  1. Crea un proyecto de Google Cloud nuevo: Los proyectos de Google Cloud nuevos tienen habilitada la desvinculación del consentimiento de OAuth. Por lo tanto, puedes crear un proyecto de Google Cloud nuevo y usarlo para probar tu aplicación.
  2. Habilita la desvinculación del consentimiento en tu proyecto existente: Puedes establecer el parámetro enable_granular_consent como verdadero en tu solicitud de autorización de OAuth.

¿Qué permisos de la API se ven afectados?
Las siguientes APIs relacionadas con los anuncios se verán afectadas por este cambio.

API Permiso de OAuth
API de Google Ads https://adwords.google.com/api/adwords
API de Google Ad Manager (API de SOAP, beta) https://www.googleapis.com/auth/dfp
https://www.googleapis.com/auth/admanager
API de Bid Manager https://www.googleapis.com/auth/doubleclickbidmanager
Content API for Shopping https://www.googleapis.com/auth/content
API de Display & Video 360 https://www.googleapis.com/auth/display-video-mediaplanning
https://www.googleapis.com/auth/display-video-user-management
API de AdMob https://www.googleapis.com/auth/admob.report
https://www.googleapis.com/auth/admob.googlebidding.readwrite
https://www.googleapis.com/auth/admob.monetization
API de AdSense para plataformas https://www.googleapis.com/auth/adsensehost
https://www.googleapis.com/auth/adsense
https://www.googleapis.com/auth/adsense.readonly
API de Google Analytics https://www.googleapis.com/auth/analytics
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics.edit
https://www.googleapis.com/auth/analytics.manage.users
https://www.googleapis.com/auth/analytics.manage.users.readonly
https://www.googleapis.com/auth/analytics.provision
https://www.googleapis.com/auth/analytics.user.deletion
API de Campaign Manager 360 https://www.googleapis.com/auth/ddmconversions
https://www.googleapis.com/auth/dfareporting
https://www.googleapis.com/auth/dfatrafficking
API de Search Ads 360 https://www.googleapis.com/auth/doubleclicksearch
API de Google Tag Manager https://www.googleapis.com/auth/tagmanager.delete.containers
https://www.googleapis.com/auth/tagmanager.edit.containers
https://www.googleapis.com/auth/tagmanager.edit.containerversions
https://www.googleapis.com/auth/tagmanager.manage.accounts
https://www.googleapis.com/auth/tagmanager.manage.users
https://www.googleapis.com/auth/tagmanager.publish
https://www.googleapis.com/auth/tagmanager.readonly
API de Real-time bidding https://www.googleapis.com/auth/realtime-bidding
API de Marketplace de Authorized Buyers https://www.googleapis.com/auth/authorized-buyers-marketplace
https://www.googleapis.com/auth/adexchange.buyer

Cómo obtener ayuda
Si tienes alguna pregunta o necesitas ayuda, comunícate con el equipo de asistencia de la API correspondiente.

Etiquetas: authentication, oauth