Flujos de aplicaciones web y de escritorio de OAuth

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 de escritorio o el flujo web. Solo debes realizar estos pasos una vez, a menos que revoques, borres o necesites cambiar los alcances 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

En los siguientes pasos, se ejecuta un ejemplo de código interactivo, por lo que deberás proporcionar información.

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

   dotnet run GenerateUserCredentials.csproj
   

2. En este ejemplo de código, se abre una URL automáticamente en el navegador. Si no accediste a tu sesión del navegador, la página web te solicitará 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 deberás 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 ingresar a Google Ads. Por lo general, se trata de 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 de cuentas. Haz clic en Continuar en la pantalla de consentimiento de OAuth 2.0.

   

   Se te redireccionará 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 conocer otras opciones de configuración.

Genera credenciales de OAuth2 para aplicaciones interactivas

Si no conoces de antemano la cuenta de Google Ads a la que debes realizar llamadas a la API, puedes descubrirla en 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 el usuario que accedió actualmente está autenticado y las credenciales de OAuth2 se obtienen en el tiempo de ejecución.