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 el flujo para computadoras de escritorio o el flujo web. Estos pasos solo deben realizarse 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 APIs de Google para la API de Google Ads.

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

    Guarda el archivo en tu directorio principal para tener el archivo local ~/client_secret_XXX.apps.googleusercontent.com.json (en el que 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 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 en la que 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 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.

    Se recuperó correctamente el código de autorización.

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

  4. Regresa a la consola en la que ejecutas el ejemplo. Verás que el ejemplo se completó y muestra tu token de actualización y algunas instrucciones, seguidas de 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.