API avanzadas

Las APIs avanzadas de las secuencias de comandos de Google Ads permiten a los desarrolladores conectarse a ciertas APIs públicas de Google con menos configuración que cuando se usan sus interfaces HTTP. Puedes usar estas APIs de forma similar a los servicios integrados de las secuencias de comandos, y ofrecen las mismas ventajas, como la finalización automática y la autorización automática.

Consulta nuestra página de fragmentos de código para ver algunos ejemplos que muestran cómo usar estas APIs.

APIs avanzadas disponibles

Google Analytics
Puedes usar Google Analytics para realizar un seguimiento del tráfico que llega a tu sitio web y ajustar las ofertas de tus campañas en consecuencia. Si vinculas una propiedad de Google Analytics a tu cuenta de Google Ads, también puedes analizar la actividad de los clientes en tu sitio web. Esta información puede resultar útil para conocer la cantidad de tráfico o de ventas en tu sitio web que provienen de Google Ads, además de ayudarte a mejorar tus anuncios y tu sitio web. Puedes obtener más información para vincular cuentas de Analytics y Google Ads en la guía del Centro de ayuda Configurar Analytics para un sitio web o una app.
Google BigQuery
Puedes cargar grandes cantidades de datos en Google Cloud Storage y, luego, consultarlos con Google BigQuery. Por ejemplo, puedes cargar datos públicos del clima de los últimos 10 años y, luego, consultar la temperatura promedio de una región en una secuencia de comandos que use esa información para ajustar las ofertas. Otro uso sería realizar cálculos numéricos sobre los datos de rendimiento de tu cuenta durante varios años.
Calendario de Google
Tu secuencia de comandos puede crear eventos para tareas futuras (por ejemplo, ejecutar un informe de rendimiento de tus campañas dentro de 2 semanas) o realizar acciones en función de una entrada que creaste en tu calendario (por ejemplo, habilitar una campaña en una fecha específica).
Presentaciones de Google
Tu secuencia de comandos puede exportar detalles o estadísticas de las campañas a Presentaciones de Google para publicar esa información en un formato presentable.
Google Tasks
Tu secuencia de comandos puede crear una lista de recordatorios para tareas futuras (por ejemplo, ejecutar un informe de rendimiento de tus campañas dentro de dos semanas) o realizar acciones en función de una entrada que creaste en tu lista de recordatorios (por ejemplo, habilitar una campaña en una fecha específica).
API de Merchant Center
Tu secuencia de comandos puede usar la API de Merchant Center para subir y administrar tus fichas de productos, y administrar tus cuentas de Google Merchant Center. En las secuencias de comandos, esto puede ser útil para verificar las fichas de productos y vincular productos específicos a anuncios específicos. La API de Merchant Center tiene sub-APIs que se pueden habilitar de forma individual en el diálogo APIs avanzadas. Puedes obtener más información para vincular tu cuenta de Google Merchant Center en la guía Registrarse como desarrollador.
Content API for Shopping
Tu secuencia de comandos puede usar Google Content API for Shopping para subir y administrar tus fichas de productos, y administrar tus cuentas de Google Merchant Center. En las secuencias de comandos, esto puede ser útil para verificar las fichas de productos y vincular productos específicos a anuncios específicos. Nota: Content API for Shopping dejará de estar disponible el 18 de agosto de 2026. En su lugar, usa la API de Merchant Center, que se describe en la sección anterior.
YouTube y YouTube Analytics
Puedes recuperar y actualizar tus videos, listas de reproducción, etc., así como los datos de rendimiento de tus videos para tomar decisiones sobre las ofertas.

Habilita las APIs avanzadas

Para ver qué APIs de Google están disponibles como APIs avanzadas, haz clic en el botón APIs avanzadas en la barra superior del editor.

Se abrirá el diálogo APIs avanzadas. Marca las APIs que deseas habilitar.

A continuación, haz clic en el vínculo Consola de APIs de Google para abrir la página Consola de APIs en la consola, con el proyecto asociado a tu secuencia de comandos o, si aún no está seleccionado, elígelo en la lista desplegable Proyecto. Para buscar las APIs que deseas usar en tu secuencia de comandos, ingresa el nombre de la API en la barra de búsqueda.

En los resultados de la búsqueda, selecciona la API y, en la página siguiente, elige Habilitar; si ves un botón Inhabilitar, significa que esta API ya está habilitada. Repite esta acción para cada API que desees habilitar.

Para ver la lista de APIs habilitadas para el proyecto, selecciona la página Panel. Verifica que aparezcan todas las APIs avanzadas que deseas usar para la secuencia de comandos.

Ahora cierra el diálogo APIs avanzadas para volver al editor. Las nuevas APIs se habilitarán para tu secuencia de comandos y estarán disponibles en la lista de autocompletar.

Consideraciones finales

Hay algunas cosas que debes tener en cuenta cuando trabajas con las APIs avanzadas.

ID del proyecto

Cada secuencia de comandos de Google Ads tiene asociado un ID de proyecto de Google Cloud (también conocido como número de proyecto). Para encontrar el número de proyecto de tu secuencia de comandos, abre la página Consola de APIs de Google desde el diálogo APIs avanzadas. Este ID de proyecto se crea cuando creas la secuencia de comandos y está vinculado al usuario que creó la secuencia de comandos de Google Ads. Si el usuario que creó la secuencia de comandos se quita de la cuenta más adelante, se le pedirá a un usuario que intente acceder a la secuencia de comandos que vuelva a autorizarla y que vuelva a configurar las dependencias de la API avanzada. También se creará un nuevo ID de proyecto de desarrollador de Google, y deberás volver a configurar las APIs avanzadas, como se explicó anteriormente en este documento.

Dependencias

Solo el usuario que creó la secuencia de comandos en la cuenta puede cambiar las dependencias de las APIs avanzadas para esa secuencia de comandos.

Permisos

Cuando se accede a las APIs, una secuencia de comandos usa los permisos del usuario que autorizó la secuencia de comandos. Asegúrate de que el usuario que autorizó la secuencia de comandos tenga el acceso necesario a todas las APIs avanzadas que se usan, así como a los datos que necesita la secuencia de comandos. Si usas la API de Google Analytics, verifica que el usuario que autorizó la secuencia de comandos tenga los permisos necesarios para la cuenta de Analytics a la que se accede.

Términos y Condiciones

Cada una de las APIs avanzadas puede tener sus propios Términos y Condiciones, que debes aceptar cuando habilites la API en la Consola de APIs de Google.

Quota

La mayoría de las APIs avanzadas tienen una cuota diaria gratuita asociada. Una vez que tu secuencia de comandos supere esta cuota, la API dejará de funcionar hasta que solicites datos adicionales o se restablezca la cuota gratuita. Para supervisar la cuota que usa tu secuencia de comandos, abre la Consola de APIs de Google para la secuencia de comandos desde el diálogo APIs avanzadas. La Consola de APIs de Google también te permite solicitar cuota adicional para la API.

Facturación

Algunas APIs avanzadas requieren que pagues por su uso. Estos pagos se administran a través del proyecto de Google Cloud asociado a tu secuencia de comandos, y no a través de Google Ads. Consulta nuestra documentación para obtener más detalles sobre cómo habilitar la facturación para el proyecto de Google Cloud de tu secuencia de comandos.