Flujos de aplicaciones web y de OAuth para computadoras de escritorio

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

En esta guía, se explica cómo configurar OAuth2 para el acceso a la API con tus credenciales y el flujo de escritorio o el flujo web. Estos pasos solo se deben realizar una vez, a menos que revoques, borres o necesites cambiar los permisos permitidos para tus credenciales de OAuth2.

Crear credenciales de OAuth2

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

  2. Para descargar el archivo JSON del cliente, haz clic en su ícono Descargar cliente de OAuth y, luego, en el botón DESCARGAR JSON en la pantalla siguiente.

    Guarda el archivo en tu directorio de inicio para que ahora tengas el archivo local ~/client_secret_XXX.apps.googleusercontent.com.json (donde XXX serán valores específicos de tu proyecto). Usaremos este archivo en el siguiente paso para ejecutar el ejemplo de código.

Configura la biblioteca cliente

  1. En una terminal, ejecuta el ejemplo GenerateUserCredentials. Usa las marcas de línea de comandos para pasar el archivo JSON que descargaste en el paso anterior.

    Para ejecutar desde la línea de comandos con Gradle

    ./gradlew --console=plain --quiet runExample \
      --example="authentication.GenerateUserCredentials \
      --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
    
  2. En el ejemplo, se te solicitará que visites una URL, donde deberás permitir que las credenciales de OAuth2 accedan a tu cuenta de Google Ads en tu nombre.

    Paste this URL in your browser:
    https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=****...
    

    Navega a la URL en una sesión de navegador privado o en una ventana de incógnito. Acceda con la misma Cuenta de Google que utiliza para acceder a Google Ads. Haz clic en Continuar en la pantalla de consentimiento de OAuth2.

    Pantalla de consentimiento

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

    El código de autorización se recuperó correctamente.

    Verifica el resultado de la consola de GenerateUserCredentials para obtener más instrucciones.

  4. Regrese a la consola en la que ejecuta el ejemplo. Verás que el ejemplo se completó y muestra tu token de actualización y algunas instrucciones, seguidas por las propiedades que necesitarás para configurar la biblioteca cliente:

    #Mon Apr 18 09:07:51 EDT 2022
    api.googleads.refreshToken=1/Yw.........................................
    api.googleads.clientId=...........-...............apps.googleusercontent.com
    api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
    api.googleads.clientSecret=........................
    
  5. Copia las líneas del comentario de fecha # al final del resultado en tu archivo ads.properties.

    Reemplaza INSERT_DEVELOPER_TOKEN_HERE por tu token de desarrollador.

    Para la configuración más fácil, coloca el archivo ads.properties en tu directorio principal.