Las APIs avanzadas de los scripts de Google Ads permiten que los desarrolladores se conecten a ciertas APIs públicas de Google con menos configuración que si usaran sus interfaces HTTP. Puedes usar estas APIs de forma muy similar a los servicios integrados de las secuencias de comandos, y ofrecen las mismas comodidades, 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
- Nota: La API avanzada
Analyticsdel diálogo APIs avanzadas se orienta a la API de Universal Analytics v3, que se cerró, y las solicitudes que se le envían fallan. Los scripts de Google Ads no admiten los servicios avanzadosAnalyticsDataniAnalyticsAdminde Google Analytics 4. Para consultar datos de Google Analytics 4 desde una secuencia de comandos, envía solicitudes HTTPS a la API de Google Analytics Data con el servicioUrlFetchAppy OAuth 2.0. También puedes vincular una propiedad Google Analytics 4 a tu cuenta de Google Ads para compartir directamente los datos de conversiones de sitios web y aplicaciones. Para obtener instrucciones de configuración, consulta la guía de configuración de Analytics. - 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 con 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 para tus campañas dentro de 2 semanas) o realizar acciones basadas en 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 la campaña 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 para tus campañas dentro de dos semanas) o realizar acciones basadas en una entrada que creaste en tu lista de recordatorios (por ejemplo, habilitar una campaña en una fecha específica).
- API de Merchant
- Tu secuencia de comandos puede usar la API de Merchant para subir y administrar tus fichas de productos, así como 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 tiene APIs secundarias que se pueden habilitar de forma individual en el cuadro de diálogo APIs avanzadas. Puedes obtener más información para vincular tu cuenta de Google Merchant Center en la guía Regístrate como desarrollador.
- Contenido de compras
- Tu secuencia de comandos puede usar la API de Google Content para Shopping para subir y administrar tus fichas de productos y administrar tus cuentas de Google Merchant Center. En los scripts, 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, que se describe en la sección anterior.
- YouTube y YouTube Analytics
- Puedes recuperar y actualizar tus videos, playlists, 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 APIs avanzadas en la barra superior del editor para mostrar el diálogo APIs avanzadas. Selecciona las APIs que quieras habilitar.
Haz clic en Guardar para guardar tus selecciones y volver al editor de secuencias de comandos. Las APIs nuevas se habilitarán para tu secuencia de comandos y estarán disponibles en la lista de autocompletado.
Consideraciones adicionales
Hay algunos aspectos que debes tener en cuenta cuando trabajes con las APIs avanzadas.
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 avanzadas, una secuencia de comandos usa los permisos del usuario que
la autorizó. El usuario que autoriza debe tener el acceso necesario a todos
los datos que requiere la secuencia de comandos. Por ejemplo, para usar la API avanzada de BigQuery,
el usuario que autoriza debe tener los permisos necesarios para el proyecto de Google Cloud
y el conjunto de datos de BigQuery de destino.
Consideraciones para las secuencias de comandos anteriores a mayo de 2019
En el caso de las secuencias de comandos creadas antes de mayo de 2019, es posible que debas habilitar manualmente las APIs correspondientes en el proyecto de Google Cloud asociado a la secuencia de comandos. Sabrás si tu secuencia de comandos se ve afectada si ves un vínculo a la consola de Google Cloud en el diálogo de APIs avanzadas.
Habilita las APIs avanzadas
En el caso de las secuencias de comandos anteriores a 2019, deberás habilitar manualmente cada API avanzada que quieras usar en tu secuencia de comandos:
- Haz clic en el botón APIs avanzadas. En la siguiente ventana de diálogo, haz clic en el vínculo a la consola de Google Cloud.
- Si tu proyecto aún no está seleccionado, selecciónalo en la lista desplegable Proyecto.
- Para buscar las APIs que quieres usar en tu secuencia de comandos, ingresa el nombre de la API en la barra de búsqueda.
- Selecciona la API en los resultados de la búsqueda y haz clic en el botón "Habilitar" en la página siguiente.
Si el usuario que creó la secuencia de comandos se quita de la cuenta más adelante, se le solicitará a cualquier usuario nuevo que intente acceder a la secuencia de comandos que vuelva a habilitar las dependencias de la API avanzada y que vuelva a autorizar la secuencia de comandos.