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 porque es adecuado para cargas de conversiones completamente automáticas y descargas de informes.

Como alternativa 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 en la Consola de API de Google ni para tus credenciales de OAuth, sigue las instrucciones que aparecen en Crea un proyecto de la Consola de API de Google y credenciales de OAuth para tu cliente.

   Para encontrar el secreto y el ID de cliente 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 OAuth.
   3. El ID y el secreto de cliente se enumeran en la página.
2. Abra un navegador web y acceda 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 usará el cliente de la API para autenticarse con Search Ads 360. Si el titular de la Cuenta de Google abandona su empresa y le quita el acceso a Search Ads 360 de la cuenta, deberá repetir este flujo de trabajo de autorización y especificar otra Cuenta de Google.

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

   sa360Api.py --login

   La secuencia de comandos te guía a través del proceso de usar el ID de cliente y el secreto 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 le solicite permiso para que el cliente OAuth acceda a los datos de Search Ads 360, asegúrese de que aparezca la Cuenta de Google a la que accedió antes. (si accedes a varias Cuentas de Google, es posible que veas otra cuenta).
   

   Al final del proceso, la secuencia de comandos sa360Api.py genera una string delimitada por comas. El primer valor es el ID de cliente que proporcionaste, el segundo valor es el secreto de cliente que proporcionaste y el tercero 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. Deberás pasar toda la string como parámetro cada vez que invoques la secuencia de comandos.

6. Agrega código a tu aplicación que haga lo siguiente:
   1. Usa 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 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 Usa OAuth 2.0 para aplicaciones instaladas a fin de obtener sugerencias sobre cómo obtener un token de acceso nuevo.