Las APIs avanzadas de las secuencias de comandos de Google Ads permiten a los desarrolladores experimentados conectarse a ciertas APIs públicas de Google con menos configuración que con las interfaces HTTP. Utilizas estas APIs de manera muy similar a los servicios integrados de las secuencias de comandos y ofrecen las mismas ventajas, como el autocompletado y la autorización automática.
Posibles usos de las APIs avanzadas
- Google Analytics
- Puedes usar Google Analytics para hacer un seguimiento del tráfico que llega a tu sitio web y ajustar las ofertas de tus campañas según corresponda. 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 proviene de Google Ads, además de ayudarte a mejorar los anuncios y el sitio web. Puedes obtener más información para vincular las cuentas de Analytics y de Google Ads en nuestro Centro de ayuda.
- Google BigQuery
- Puedes cargar grandes cantidades de datos en Google Cloud Storage y, luego, consultar esos datos con Google BigQuery. Por ejemplo, puedes cargar datos meteorológicos públicos 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 un análisis de los números de los datos de rendimiento de la cuenta durante varios años.
- YouTube y YouTube Analytics
- Puedes recuperar y actualizar tus videos, playlists, etc., así como los datos de rendimiento de los videos, para tomar decisiones sobre las ofertas.
- 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 a partir de hoy) o realizar acciones basadas en una entrada que creaste en tu calendario (por ejemplo, habilitar una campaña en una fecha específica).
- Shopping Content
- Tu secuencia de comandos puede usar Google Content API for Shopping en Apps Script. Esta API brinda a los usuarios de Google Merchant Center la capacidad de subir y administrar sus fichas de productos, así como administrar sus cuentas de Merchant Center. En las secuencias de comandos, esto puede ser útil para verificar las fichas de productos y vincular productos específicos a anuncios determinados.
- 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 a partir de hoy) 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).
- Presentaciones de Google
- La 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.
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 del editor superior.
Se abrirá el cuadro de diálogo Advanced APIs. Marca las APIs que deseas habilitar.
Luego, haz clic en el vínculo de la Consola de API de Google para abrir la página Consola de APIs en Console, con el proyecto asociado con tu secuencia de comandos. Si el proyecto aún no está seleccionado, selecciónalo en la lista desplegable Proyectos. 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 el botón Inhabilitar, 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 Advanced APIs para volver al editor. Las nuevas APIs se habilitarán para tu secuencia de comandos y estarán disponibles en la lista de autocompletar.
API disponibles
Las siguientes APIs se encuentran disponibles para usarse:
| Nombre de la API | Documentación |
|---|---|
| Google Analytics | https://developers.google.com/apps-script/advanced/analytics |
| Google BigQuery | https://developers.google.com/apps-script/advanced/bigquery |
| Calendario de Google | https://developers.google.com/apps-script/advanced/calendar |
| Presentaciones de Google | https://developers.google.com/apps-script/advanced/slides |
| Google Tasks | https://developers.google.com/apps-script/advanced/tasks |
| Shopping Content | https://developers.google.com/apps-script/advanced/shopping-content |
| YouTube | https://developers.google.com/apps-script/advanced/youtube |
| YouTube Analytics | https://developers.google.com/apps-script/advanced/youtube-analytics |
También puedes consultar nuestra página de fragmentos de código para ver algunos ejemplos de cómo usar estas APIs.
Consideraciones finales
Debes tener en cuenta algunos aspectos cuando trabajes con las APIs avanzadas.
ID del proyecto
Cada secuencia de comandos de Google Ads tiene un ID del proyecto de Google Cloud Platform (también conocido como número de proyecto) asociado. Para encontrar el número de proyecto de tu secuencia de comandos, abre la página de la Consola de APIs de Google desde el cuadro de diálogo API avanzadas. Este ID del proyecto se crea cuando creas la secuencia de comandos y se vincula al usuario que creó la secuencia de comandos de Google Ads. Si luego se quita al usuario que creó la secuencia de comandos de la cuenta, se le solicitará al usuario que intente acceder a la secuencia de comandos que vuelva a autorizarla y que configure las dependencias de la API avanzada de nuevo. También se creará un nuevo ID del 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.
Permisos
Cuando accedes a las APIs, una secuencia de comandos usa los permisos del usuario que la autorizó. Asegúrate de que el usuario que autorizó la secuencia de comandos tenga el acceso necesario a todas las APIs avanzadas que se están utilizando, así como los datos que necesita la secuencia de comandos. Si utilizas la API de Google Analytics, asegúrate de que el usuario que autorizó la secuencia de comandos tenga los permisos necesarios para acceder a la cuenta de Analytics.
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.
Cuota
La mayoría de las APIs avanzadas tienen asociada una cuota diaria sin cargo. Una vez que la secuencia de comandos supere esta cuota, la API dejará de funcionar hasta que solicites datos adicionales o se reabastezca la cuota gratuita. Puedes supervisar la cuota que usa tu secuencia de comandos si abres la Consola de APIs de Google para la secuencia de comandos desde el cuadro de diálogo APIs avanzadas. La Consola de APIs de Google también te proporciona una forma de solicitar cuota adicional para la API.
Facturación
Algunas APIs avanzadas requieren que pagues para usarlas. Estos pagos se administran a través del proyecto de Google Cloud Platform 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 tu proyecto de Google Cloud Platform de la secuencia de comandos.