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 tu propio 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 quieras realizar llamadas a la API con una sola Cuenta de administrador de Google Ads.

  2. Usa la GenerateUserCredentials. ejemplo para generar credenciales OAuth2 para un usuario con acceso al administrador de servicio predeterminada.

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

Solo debes realizar estos pasos una vez, a menos que los 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 el 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 GenerateUserCredentials , que te solicita tu ID y secreto de cliente de OAuth2.

    Este es un ejemplo interactivo en el que deberás proporcionar 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 acceso. y te redireccionará a una URL en la que se te pedirá que autorices la solicitud para acceder a tu cuenta de Google Ads en tu nombre.

    Pantalla de consentimiento

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

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

  5. Regresa a la consola donde estabas ejecutando el ejemplo. El ejemplo debe completar y mostrar su 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 sabe cuál es la cuenta de Google Ads a la que debe realizar llamadas a la API con anticipación, puede descubrirla en el tiempo de ejecución usando las credenciales del usuario que accedió para el sesión. Consulta AuthenticateInAspNetCoreApplication de un ejemplo en el que se autentica al usuario que accedió y la autenticación de OAuth2 y las credenciales se obtienen en el tiempo de ejecución.