Guía de inicio rápido

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 requeridas. 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.

Prerequisites

Parámetros de configuración

Deberás proporcionar 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 el token no está restringido a solo una cuenta de Google Ads. Una vez aprobado su token, puede usar el mismo token para las solicitudes en todas sus 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 las 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 las cuentas de prueba.

Para recuperar el token de desarrollador, accede a tu cuenta de administrador y, luego, navega al Centro de API (HERRAMIENTAS Y CONFIGURACIONES > CONFIGURACIÓN & Centro de API).

Puntos clave

  • Una empresa debe tener solo un token de desarrollador.
  • Cuando se usa un ID de cliente de un proyecto de Google Cloud con un token de desarrollador, este se vincula al token de desarrollador y no se puede usar con otro token de desarrollador. En otras palabras:
    • Se puede usar un token de desarrollador con varios ID de cliente.
    • Sin embargo, se puede usar un ID de cliente con solo un token de desarrollador.
ID de cliente

El ID de cliente es el número de la cuenta de cliente de Google Ads que deseas administrar con la API, por lo general, en el formato 123-456-7890.

De manera opcional, el ID de cliente del cliente se puede dejar 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 ID de cliente de OAuth2

El ID y el secreto de cliente de OAuth2 asignan la app cliente a un proyecto en la Consola de API de Google y se usan para la autenticación de OAuth2. Esto permite que la app funcione en nombre de tu cuenta. Identifican tu app para Google y te permiten generar tokens OAuth con el objetivo de 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

Para que tu app pueda acceder a datos privados con la API, debe obtener un token de acceso de OAuth2 que le otorgue acceso a la API.

Si usas las bibliotecas cliente, el token de acceso de OAuth2 se encarga automáticamente. De lo contrario, consulta el ejemplo de llamada a la API en la guía de OAuth2 para obtener detalles sobre cómo generar un token de acceso.

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.

Los tokens de acceso y actualización de OAuth2 tienen instrucciones para crear el token de actualización.

Para obtener más información sobre el uso de OAuth2 con las API de Google, consulta la documentación de Autenticación de OAuth2 y de la plataforma de identidad de OAuth2.