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 configura el archivo de configuración, está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 limita a una sola cuenta de Google Ads. Una vez que se apruebe, podrás usar el mismo token en todas las cuentas de Google Ads, incluso si no están vinculadas a la cuenta de administrador de Google Ads asociada a él.
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 las cuentas secundarias.
Solo los tokens aprobados pueden conectarse a la API para las cuentas de Google Ads de producción: Los tokens pendientes solo pueden conectarse a cuentas de prueba.
Para recuperar el token de desarrollador, accede a tu cuenta de administrador y, luego, navega al Centro de API (TOOLS & SETTINGS > SETUP > API Center).
- 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 manera opcional, el ID de cliente puede dejarse fuera del archivo de configuración y configurarse 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 de OAuth2 y secreto del cliente
El ID y el secreto de cliente de OAuth2 asignan tu aplicación cliente a un proyecto en la consola de las API de Google y se utilizan para la autenticación OAuth2, lo que permite a tu aplicación operar en nombre de tu cuenta. Identifican tu app para 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.
- Tokens de acceso y actualización de OAuth2
Antes de que tu app pueda acceder a datos privados con 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 ocupa de manera automática. De lo contrario, intenta obtener tokens a través de OAuth Playground.
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. En Acceso y token de actualización, se incluyen instrucciones para crear el token de actualización.