Flujos de aplicaciones web y de escritorio de OAuth

Advertencia: A partir de la versión 19.0.0, la biblioteca cliente de la API de Google Ads para .NET ya no será compatible con .NET 5.0. Para garantizar un funcionamiento sin problemas, te recomendamos que actualices tu versión de .NET antes de fin de 2024.

En esta guía, se explica cómo configurar OAuth 2.0 para el acceso a la API con tus propias credenciales y el flujo para computadoras de escritorio o el flujo web. Solo debes realizar estos pasos una vez, a menos que revoques, borres o necesites cambiar los permisos permitidos para tus credenciales de OAuth 2.0.

Crea credenciales de OAuth 2.0

1. Sigue los pasos para configurar un proyecto de la Consola de APIs de Google para la API de Google Ads.

2. Anota el ID de cliente y el secreto del cliente y, luego, vuelve a esta página.

Configura la biblioteca cliente

Los siguientes pasos ejecutan un ejemplo de código interactivo, que requerirá que proporciones entradas.

1. En una terminal, ejecuta el ejemplo de GenerateUserCredentials. Ingresa el ID de cliente y el secreto de cliente de OAuth 2.0 cuando se te solicite.

   dotnet run GenerateUserCredentials.csproj
   

2. En este ejemplo de código, se abre una URL automáticamente en el navegador. Si no accediste a la sesión del navegador, la página web te pedirá que accedas a tu Cuenta de Google. Si ya accediste, se omitirá el mensaje de acceso y se te redireccionará a una URL en la que debes autorizar a la app para que acceda a tu cuenta de Google Ads en tu nombre.

   Accede con la Cuenta de Google que usas para acceder a Google Ads. Por lo general, es un correo electrónico de acceso a una cuenta de administrador de Google Ads que contiene todas las cuentas que necesitas administrar en su jerarquía. Haz clic en Continuar en la pantalla de consentimiento de OAuth 2.0.

   

   Se te dirigirá a una página con un mensaje que indica que la autorización se realizó correctamente.

   Your refresh token has been fetched. Check the
   console output for further instructions.

3. Regresa a la consola en la que ejecutas el ejemplo de código. Verás que el ejemplo de código se completó y muestra tu token de actualización y algunas instrucciones, seguidas de las instrucciones que deberás seguir para configurar la biblioteca cliente:

   Copy the following content into your App.config file.
   
   <add key = 'OAuth2Mode' value = 'APPLICATION' />
   <add key = 'OAuth2ClientId' value = '******' />
   <add key = 'OAuth2ClientSecret' value = '******' />
   <add key = 'OAuth2RefreshToken' value = '******' />
   

   Asegúrate de configurar también el encabezado LOGIN_CUSTOMER_ID en tu archivo App.config. Consulta la guía de configuración para obtener más información.

   <add key = 'LoginCustomerId' value = 'INSERT_LOGIN_CUSTOMER_ID_HERE' />
   

   Consulta la guía de configuración para ver opciones de configuración alternativas.

Genera credenciales de OAuth2 para aplicaciones interactivas

Si no conoces la cuenta de Google Ads a la que debes realizar llamadas a la API con anticipación, puedes descubrirla durante el tiempo de ejecución con las credenciales del usuario que accedió a la sesión. Consulta AuthenticateInAspNetCoreApplication para ver un ejemplo en el que se autentica el usuario que accedió actualmente y se obtienen las credenciales de OAuth2 durante el tiempo de ejecución.