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 admitirá .NET 5.0. Para garantizar un funcionamiento sin interrupciones, te recomendamos que actualices la versión de .NET antes de finales de 2024.

En esta guía, se explica cómo configurar OAuth2 para el acceso a la API con tus propias credenciales y el flujo de escritorio o el flujo web.

Genera credenciales de OAuth2 para una sola cuenta

La forma más sencilla de realizar llamadas a las cuentas de la API de Google Ads es

1. Vincula todas las cuentas a las que deseas realizar llamadas a la API en una sola cuenta de administrador de Google Ads.

2. Usa el ejemplo de GenerateUserCredentials para generar credenciales de OAuth2 para un usuario con acceso a la cuenta de administrador.

3. Usa las credenciales de OAuth2 para realizar llamadas a todas las cuentas que necesitas administrar con la API de Google Ads.

Estos pasos solo deben realizarse una vez, a menos que revoques, borres o necesites cambiar los permisos permitidos para tus credenciales de OAuth2.

Paso 1: Crea credenciales de OAuth2

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

2. Toma nota del ID de cliente y del secreto, luego regresa a esta página.

Paso 2: Configura la biblioteca cliente

1. En una terminal, ejecuta el ejemplo de GenerateUserCredentials, que te solicita tu ID y secreto de cliente de OAuth2.

   Este es un ejemplo interactivo, en el que deberás proporcionar una entrada.

   dotnet run GenerateUserCredentials.csproj
   

2. El ejemplo te solicita que proporciones el ID de cliente y el secreto de OAuth2. Proporciona los detalles del paso 1.

3. El ejemplo 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 la Cuenta de Google. Si ya accediste, se omitirá el mensaje de acceso y se te redireccionará a una URL en la que se te pedirá que autorices a la aplicación para acceder a tu cuenta de Google Ads en tu nombre.

   Nota: Ingresa con la misma Cuenta de Google que utilizas para acceder a Google Ads. Por lo general, es una dirección de correo electrónico de acceso a una cuenta de administrador de Google Ads que contiene todas las cuentas que debes administrar según su jerarquía de cuentas.

   

4. Luego, verás una página con un mensaje que indica que la autorización se realizó correctamente.

   Se recuperó tu token de actualización. Consulta el resultado de la consola para obtener más instrucciones.

5. Regresa a la consola donde estabas ejecutando el ejemplo. El ejemplo debería haberse completado y mostrar tu token de actualización y algunas instrucciones, seguidas de las propiedades que necesitarás 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 = '******' />
   
   Make sure you also set the LOGIN_CUSTOMER_ID header. See
   https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration#google_ads_api_settings
   to learn more.
   
   <add key = 'LoginCustomerId' value = 'INSERT_LOGIN_CUSTOMER_ID_HERE' />
   
   See https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration
   for alternate configuration options.
   

Genera credenciales de OAuth2 para aplicaciones interactivas

Si no conoces la cuenta de Google Ads para realizar llamadas a la API con anticipación, puedes encontrarla 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 se autentica el usuario que accedió y se obtienen las credenciales de OAuth2 en el tiempo de ejecución.