Guía de inicio rápido

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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 tu 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 tu token, puedes usarlo para 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 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 navega al Centro de API (HERRAMIENTAS &CONFIGURACIÓN > CONFIGURACIÓN > Centro de API).

ID de cliente

El ID de cliente es el número 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 establecerse de manera programática. Una vez que se apruebe el token de desarrollador, puedes 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 de cliente 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 para Google y te permiten generar tokens OAuth para administrar usuarios de Google Ads. Consulta Crea un ID de cliente y un secreto de 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 encarga automáticamente. De lo contrario, intenta obtener tokens mediante el 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.