Flujos de aplicaciones web y de escritorio de OAuth

En esta guía, se explica cómo configurar OAuth2 para el acceso a la API con tus propias credenciales y con 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 GenerateUserCredentials a fin de 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 mediante 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 y, luego, regresa a esta página.

Paso 2: Configura la biblioteca cliente

  1. En una terminal, ejecuta el ejemplo de GenerateUserCredentials, que 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. En el ejemplo, se 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 de tu navegador, en la página web se te solicitará 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 solicitará que autorices a la aplicación para que acceda a tu cuenta de Google Ads en tu nombre.

    Pantalla de consentimiento

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

    Se recuperó tu token de actualización. Verifica la salida de la consola para obtener más instrucciones.

  5. Regresa a la consola en la que ejecutaste el ejemplo. El ejemplo debería haberse completado y mostrar el 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 OAuth2 para aplicaciones interactivas

Si no conoces la cuenta de Google Ads para realizar llamadas a la API con anticipación, puedes descubrirla durante el tiempo de ejecución con las credenciales del usuario registrado para 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.