Configurar autorización

La API de Search Ads 360 requiere que todas las solicitudes especifiquen un token de acceso de OAuth 2.0 para la autenticación. Puedes seguir cualquier flujo de trabajo de autenticación estándar de OAuth 2.0 para generar el token y pasarlo a la API de Search Ads 360. Recomendamos el flujo de trabajo que se describe a continuación, ya que es adecuado para las cargas de conversiones y las descargas de informes completamente automatizadas.

Si deseas conocer alternativas al flujo de trabajo que se describe a continuación, consulta Usa OAuth 2.0 para aplicaciones instaladas o Usa OAuth 2.0 para aplicaciones de servidor a servidor. Si usas un flujo de trabajo alternativo, especifica el siguiente valor como el parámetro scope cuando solicites un código de autorización de OAuth 2.0:
https://www.googleapis.com/auth/doubleclicksearch
Si sigues la ruta de servidor a servidor, agrega la cuenta de servicio como usuario de Search Ads 360.

Flujo de trabajo de autorización recomendado

1. Ve a la Consola de API de Google y selecciona tu proyecto.

   Si aún no creaste un proyecto de la Consola de la API de Google ni credenciales de OAuth, sigue las instrucciones que se indican en Cómo crear un proyecto de la Consola de la API de Google y credenciales de OAuth para tu cliente.

   Para encontrar el ID de cliente y el secreto de OAuth de tu proyecto, haz lo siguiente:

   1. Abre la página Credenciales.
   2. En la columna Nombre, haz clic en el nombre de tu cliente de OAuth.
   3. El ID de cliente y el secreto aparecen en la página.
2. Abre un navegador web y accede a Google con una Cuenta de Google que tenga permiso para acceder a los datos en Search Ads 360.

   Esta es la Cuenta de Google que tu cliente de la API usará para autenticarse con Search Ads 360. Si el titular de la Cuenta de Google abandona tu empresa y quitas el acceso a Search Ads 360 de la cuenta, deberás repetir este flujo de trabajo de autorización y especificar otra Cuenta de Google.

3. Para obtener un token de actualización, invoca la secuencia de comandos de utilidad de Search Ads 360 de la siguiente manera:

   sa360Api.py --login

   La secuencia de comandos te guía por el proceso de usar el ID y el secreto de cliente de OAuth para obtener un token de actualización. El token de actualización solo es válido para la Cuenta de Google a la que accediste en el paso anterior.

   Como parte de este proceso, la secuencia de comandos genera una URL y te indica que la visites en un navegador web.

4. Cuando el navegador te solicite que permitas que el cliente de OAuth acceda a los datos de Search Ads 360, asegúrate de que aparezca la Cuenta de Google a la que accediste antes. (si accediste a varias Cuentas de Google, es posible que veas una cuenta diferente).
   

   Al final del proceso, la secuencia de comandos sa360Api.py genera una cadena delimitada por comas. El primer valor es el ID de cliente que proporcionaste, el segundo es el secreto del cliente que proporcionaste y el tercer valor es el token de actualización. En el siguiente resultado de ejemplo, el token de actualización está en texto en negrita:
   123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw

5. Almacena el ID de cliente, el secreto de cliente y el token de actualización en una base de datos de backend o en otra ubicación segura a la que pueda acceder tu aplicación.

   Mantén toda la string delimitada por comas en una ubicación conveniente si planeas usar sa360Api.py para enviar solicitudes JSON de muestra a la API de Search Ads 360. Pasarás la cadena completa como parámetro cada vez que invoques la secuencia de comandos.

6. Agrega a tu aplicación código que realice las siguientes acciones:
   1. Utiliza el ID de cliente, el secreto de cliente y el token de actualización para obtener un nuevo token de acceso de OAuth 2.0.
   2. Envía solicitudes a la API de Search Ads 360 con el token de acceso nuevo.

   Si usas las bibliotecas cliente, en la siguiente sección, Configura tu aplicación, se describe cómo agregar este código de autorización a tu aplicación.

   Si no usas una de las bibliotecas cliente, consulta Cómo usar OAuth 2.0 para aplicaciones instaladas para obtener sugerencias sobre cómo obtener un token de acceso nuevo.