En esta guía, se utiliza una biblioteca cliente para recuperar campañas de Google Ads.
Para habilitar el acceso a la API, primero obtén las credenciales de OAuth2 necesarias.
Luego, agrega la autorización y los detalles de la cuenta a un archivo de configuración. Una vez que se configure el archivo de configuración, estarás listo para llamar a la API.
Parámetros de configuración para la biblioteca cliente
Proporciona la siguiente información en el archivo de configuración de la biblioteca cliente.
- Token de programador
Tu token de desarrollador permite que tu app acceda a la API, pero no se restringe a una sola cuenta de Google Ads. Una vez que se aprueba el token, puedes usar el mismo token para las solicitudes en todas tus cuentas de Google Ads, incluso si no están vinculadas a la cuenta de administrador de Google Ads asociada con el token.
Las cuentas que administras están autorizadas por credenciales de OAuth de la cuenta de administrador. Una cuenta de administrador requiere solo un conjunto de credenciales para administrar todas sus cuentas secundarias.
Solo los tokens aprobados pueden conectarse a la API para las cuentas de producción de Google Ads; los tokens pendientes solo pueden conectarse a las cuentas de prueba.
Para recuperar tu token de desarrollador, accede a tu cuenta de administrador y, luego, navega al Centro de API (HERRAMIENTAS Y CONFIGURACIÓN > CONFIGURACIÓN > Centro de API).
- ID de cliente
El ID de cliente es el número de cuenta de la cuenta cliente de Google Ads que deseas administrar con la API, por lo general, con el formato
123-456-7890.
De forma opcional, el ID de cliente puede dejarse fuera del archivo de configuración y establecerse de manera programática. Una vez que se apruebe el token de desarrollador, podrás usar un ID de cliente de una cuenta de producción en lugar de una cuenta de prueba.
- ID de cliente y secreto de cliente de OAuth2
El ID y el secreto de cliente de OAuth2 asignan tu app cliente a un proyecto en la Consola de API de Google y se usan para la autenticación de OAuth2, lo que permite que tu app funcione en nombre de tu cuenta. Identifican tu app ante Google y te permiten generar tokens OAuth para administrar usuarios de Google Ads. Consulta Cómo crear un ID de cliente y un secreto del cliente para obtener más detalles.
- Acceso de OAuth2 y tokens de actualización
Antes de que tu app pueda acceder a los datos privados mediante la API, debe obtener un token de acceso de OAuth2 que otorgue acceso a la API.
Si usas las bibliotecas cliente, el token de acceso de OAuth2 se encarga de manera automática. De lo contrario, intenta obtener tokens a través del Playground de OAuth.
Los tokens de acceso de OAuth2 vencen después de un tiempo limitado. Por este motivo, las bibliotecas cliente usan el token de actualización de OAuth2 para regenerar automáticamente el token de acceso de OAuth2. El token de acceso y actualización tiene instrucciones para crear el token de actualización.