API avanzate

Le API avanzate negli script Google Ads consentono agli sviluppatori di connettersi a determinate API di Google pubbliche con meno configurazione rispetto all'utilizzo delle relative interfacce HTTP. Puoi utilizzare queste API in modo simile ai servizi integrati degli script e offrono le stesse comodità, come il completamento automatico e l'autorizzazione automatica.

Consulta la nostra pagina degli snippet di codice per alcuni esempi che mostrano come utilizzare queste API.

API avanzate disponibili

Google Analytics
Puoi utilizzare Google Analytics per monitorare il traffico diretto al tuo sito web e modificare le offerte della campagna di conseguenza. Se colleghi una proprietà Google Analytics al tuo account Google Ads, puoi anche analizzare l'attività dei clienti sul tuo sito web. Queste informazioni possono aiutarti a capire quanta parte del traffico sul sito web o delle vendite sia generata da Google Ads, consentendoti, in questo modo, di migliorare sia gli annunci che il sito web. Puoi scoprire di più sul collegamento degli account Analytics e Google Ads nella guida del Centro assistenza Configurare Analytics per un sito web e/o un'app.
Google BigQuery
Puoi caricare grandi quantità di dati in Google Cloud Storage e poi eseguire query su questi dati utilizzando Google BigQuery. Ad esempio, puoi caricare i dati meteorologici pubblici degli ultimi 10 anni e quindi eseguire una query per la temperatura media di una regione in uno script che utilizza queste informazioni per modificare le offerte. Un altro utilizzo potrebbe essere quello di eseguire calcoli sui dati sul rendimento del tuo account per diversi anni.
Google Calendar
Lo script può creare eventi per attività future (ad esempio, generare un report sul rendimento delle tue campagne tra due settimane) o eseguire azioni in base a una voce che hai creato nel calendario (ad esempio, attivare una campagna in una data specifica).
Presentazioni Google
Lo script può esportare i dettagli o le statistiche della campagna in Presentazioni Google per pubblicare queste informazioni in un formato presentabile.
Google Tasks
Lo script può creare un elenco di promemoria per attività future (ad esempio, eseguire un report sul rendimento delle campagne tra due settimane) o eseguire azioni in base a una voce creata nell'elenco dei promemoria (ad esempio, attivare una campagna in una data specifica).
API Merchant
Lo script può utilizzare l'API Merchant per caricare e gestire le tue schede di prodotto e gestire i tuoi account Google Merchant Center. Negli script, questa opzione può essere utile per controllare le schede di prodotto e collegare prodotti specifici ad annunci specifici. L'API Merchant ha API secondarie che possono essere abilitate singolarmente nella finestra di dialogo API avanzate. Puoi scoprire di più sul collegamento del tuo account Google Merchant Center nella guida Registrati come sviluppatore.
Contenuti di Shopping
Lo script può utilizzare l'API Google Content for Shopping per caricare e gestire le tue schede di prodotto e gestire i tuoi account Google Merchant Center. Negli script, questa opzione può essere utile per controllare le schede di prodotto e collegare prodotti specifici ad annunci specifici. Nota:l'API Content for Shopping verrà ritirata il 18 agosto 2026. Utilizza invece l'API Merchant, descritta nella sezione precedente.
YouTube e YouTube Analytics
Puoi recuperare e aggiornare i tuoi video, le tue playlist e così via, nonché i dati sul rendimento dei tuoi video per prendere decisioni sulle offerte.

Abilitare le API avanzate

Per vedere quali API di Google sono disponibili come API avanzate, fai clic su API avanzate nella barra dell'editor in alto per visualizzare la finestra di dialogo API avanzate. Seleziona le API che vuoi abilitare.

Fai clic su Salva per salvare le selezioni e tornare all'editor di script. Le nuove API verranno attivate per lo script e saranno disponibili nell'elenco di completamento automatico.

Considerazioni aggiuntive

Ci sono alcune cose da tenere presenti quando si utilizzano le API avanzate.

Dipendenze

Solo l'utente che ha creato lo script nell'account può modificare le dipendenze delle API avanzate per lo script.

Autorizzazioni

Quando accede alle API, uno script utilizza le autorizzazioni dell'utente che ha autorizzato lo script. Assicurati che l'utente che ha autorizzato lo script disponga dell'accesso necessario a tutti i dati di cui lo script ha bisogno. Se utilizzi l'API Google Analytics, verifica che l'utente che ha autorizzato lo script disponga delle autorizzazioni necessarie per l'account Analytics a cui si accede.

Considerazioni per i copioni precedenti a maggio 2019

Per gli script creati prima di maggio 2019, potrebbe essere necessario abilitare manualmente le API pertinenti nel progetto Google Cloud associato allo script. Saprai se il tuo script è interessato se vedi un link alla console Google Cloud nella finestra di dialogo delle API avanzate.

Abilitare le API avanzate

Per gli script precedenti al 2019, devi attivare manualmente ogni API avanzata che vuoi utilizzare nello script:

  1. Fai clic sul pulsante API avanzate. Nella finestra di dialogo successiva, fai clic sul link alla console Google Cloud.
  2. Se il progetto non è già selezionato, selezionalo dall'elenco a discesa Progetto.
  3. Cerca le API che vuoi utilizzare nello script inserendo il nome dell'API nella barra di ricerca.
  4. Seleziona l'API dai risultati di ricerca e fai clic sul pulsante "Attiva" nella pagina successiva.

Se l'utente che ha creato lo script viene rimosso in un secondo momento dall'account, a qualsiasi nuovo utente che tenta di accedere allo script verrà chiesto di attivare nuovamente le dipendenze dell'API avanzata e di autorizzare nuovamente lo script.