API avanzadas

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 si usaran sus interfaces HTTP. Estas APIs se usan de forma muy similar a los servicios integrados de las secuencias de comandos y ofrecen las mismas ventajas, como la autocompletar 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 en consecuencia. 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 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 sobre cómo vincular las 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, consultar esos datos 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 complejos 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 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 la Content API de Google 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 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 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
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.

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.

Aparecerá el diálogo Advanced APIs. 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. Si tu proyecto 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 quieras habilitar.

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

Ahora, cierra el diálogo de 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.

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 de cómo usar estas APIs.

Consideraciones finales

Cuando trabajes con las APIs avanzadas, ten en cuenta lo siguiente:

ID del proyecto

Cada secuencia de comandos de Google Ads tiene un ID de proyecto de Google Cloud (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 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 Google Developers, 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 de esa secuencia.

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 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 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 restablezca la cuota gratuita. Puedes supervisar la cuota que usa tu secuencia de comandos. Para ello, 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 el uso. 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 el proyecto de Google Cloud Platform de tu secuencia de comandos.