Las APIs avanzadas de las secuencias de comandos de Google Ads permiten que los desarrolladores experimentados se conecten a ciertas APIs públicas de Google con menos configuración que con sus interfaces HTTP. Puedes usar estas APIs de la misma manera que 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.
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 tu campaña según corresponda. Si vinculas una propiedad de Google Analytics a tu cuenta de Google Ads, también podrás analizar la actividad de los clientes en tu sitio web. Esta información puede resultar útil para conocer la cantidad de ventas o tráfico de tu sitio web que proviene 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 nuestro Centro de ayuda.
- Google BigQuery
- Puedes cargar grandes cantidades de datos en Google Cloud Storage y, luego, consultarlos con Google BigQuery. Por ejemplo, puedes cargar datos climáticos 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 cálculos sobre los datos de rendimiento de tu cuenta durante varios años.
- 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.
- 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 según 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 la Content API de Google para Shopping en Apps Script. Esta API les permite a los usuarios de Google Merchant Center subir y administrar sus fichas de productos, así como 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 específicos.
- 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 según una entrada que creaste en tu lista de recordatorios (por ejemplo, habilitar una campaña en una fecha específica).
- Presentaciones de Google
- Tu secuencia de comandos puede exportar estadísticas o detalles 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 de editor superior.
Se abrirá el diálogo APIs avanzadas. Verifica las APIs que deseas habilitar.
A continuación, haz clic en el vínculo Consola de APIs de Google para abrir la página API Console en la Consola, con el proyecto asociado a tu secuencia de comandos. Si tu proyecto aún no está seleccionado, selecciónalo 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 siguiente página, 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 todas las APIs avanzadas que deseas usar para la secuencia de comandos aparezcan en la lista.
Ahora, cierra el diálogo de APIs avanzadas para volver al editor. Las APIs nuevas se habilitarán para tu secuencia de comandos y estarán disponibles en la lista de autocompletar.
API disponibles
Las siguientes APIs están disponibles para su uso:
| 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 sobre cómo usar estas APIs.
Consideraciones finales
Hay algunos aspectos que debes tener en cuenta cuando trabajes con las APIs avanzadas.
ID del proyecto
Cada secuencia de comandos de Google Ads tiene un ID de proyecto (también conocido como número de proyecto) de Google Cloud Platform 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 diálogo APIs avanzadas. Este ID del proyecto se crea cuando creas la secuencia de comandos y está vinculado al usuario que la creó. Si el usuario que creó la secuencia de comandos se quita más adelante de la cuenta, se le pedirá al usuario que intente acceder a ella que vuelva a autorizarla y configurar las dependencias de la API avanzada. También se creará un nuevo ID de proyecto de desarrollador de Google, y deberás configurar las APIs avanzadas nuevamente, como se explicó antes en este documento.
Dependencias
Solo el usuario que creó la secuencia de comandos en la cuenta puede cambiar las dependencias de las APIs avanzadas de esa secuencia de comandos.
Permisos
Cuando se accede 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 requerido 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, 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 la API de Google.
Cuota
La mayoría de las APIs avanzadas tienen una cuota diaria sin cargo asociada. Una vez que tu secuencia de comandos supere esta cuota, la API dejará de funcionar hasta que solicites datos adicionales o se reabastezca la cuota gratuita. Para supervisar la cuota que usa tu secuencia de comandos, abre la consola de la API de Google para la secuencia de comandos desde el diálogo APIs avanzadas. La Consola de API de Google también te brinda una forma de solicitar una cuota adicional para la API.
Facturación
Algunas APIs avanzadas requieren que pagues por el uso. Estos pagos se administran a través del proyecto de Google Cloud Platform asociado con 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 Platform de tu secuencia de comandos.