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.

Per alcuni esempi che mostrano come utilizzare queste API, consulta la nostra pagina relativa agli snippet di codice.

API avanzate disponibili

Google Analytics

Puoi utilizzare Google Analytics per monitorare il traffico diretto al tuo sito web e modificare di conseguenza le offerte delle campagne. 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 poi eseguire una query sulla 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 dell'account per diversi anni.

Google Calendar

Lo script può creare eventi per attività future (ad esempio, eseguire un report sul rendimento delle campagne tra due settimane) o eseguire azioni in base a una voce creata nel calendario (ad esempio, attivare una campagna in una data specifica).

Presentazioni Google

Lo script può esportare i dettagli o le statistiche delle campagne 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 schede di prodotto e gestire gli account Google Merchant Center. Negli script, questa operazione 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 Registrarsi come sviluppatore.

Contenuti Shopping

Lo script può utilizzare l'API Google Content for Shopping per caricare e gestire le schede di prodotto e gestire gli account Google Merchant Center. Negli script, questa operazione 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 playlist e così via, nonché i dati sul rendimento dei video per prendere decisioni sulle offerte.

Abilitare le API avanzate

Per vedere quali API di Google sono disponibili come API avanzate, fai clic sul pulsante API avanzate nella barra dell'editor in alto.

Viene visualizzata la finestra di dialogo API avanzate. Seleziona le API che vuoi abilitare.

Poi, fai clic sul link Console API di Google per visualizzare la pagina Console API nella console, con il progetto associato allo script; in alternativa, se il progetto non è già selezionato, selezionalo dall'elenco a discesa Progetto. Cerca le API che vuoi utilizzare nello script inserendo il nome dell'API nella barra di ricerca.

Nei risultati di ricerca, seleziona l'API e nella pagina seguente scegli Abilita; se vedi un pulsante Disabilita, significa che l'API è già abilitata. Ripeti questa azione per ogni API che vuoi abilitare.

Per visualizzare l'elenco delle API abilitate per il progetto, seleziona la pagina Dashboard. Verifica che siano elencate tutte le API avanzate che vuoi utilizzare per lo script.

Ora chiudi la finestra di dialogo API avanzate per tornare all'editor. Le nuove API verranno abilitate per lo script e saranno disponibili nell'elenco di completamento automatico.

Considerazioni finali

Quando utilizzi le API avanzate, devi tenere presenti alcune cose.

ID progetto

A ogni script Google Ads è associato un ID progetto Google Cloud (noto anche come numero di progetto). Puoi trovare il numero di progetto dello script aprendo la pagina della console API di Google dalla finestra di dialogo API avanzate. Questo ID progetto viene creato quando crei lo script ed è collegato all'utente che ha creato lo script Google Ads. Se l'utente che ha creato lo script viene rimosso in un secondo momento dall'account, a un utente che tenta di accedere allo script verrà chiesto di autorizzare nuovamente lo script e di configurare di nuovo le dipendenze delle API avanzate. Verrà creato anche un nuovo ID progetto sviluppatore Google e dovrai configurare di nuovo le API avanzate, come spiegato in precedenza in questo documento.

Dipendenze

Solo l'utente che ha creato lo script nell'account può modificare le dipendenze delle API avanzate per quello 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 abbia l'accesso richiesto a tutte le API avanzate utilizzate, nonché ai 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.

Termini e condizioni

Ogni API avanzata può avere Termini e condizioni propri che devi accettare quando abiliti l'API nella console API di Google.

Quota

La maggior parte delle API avanzate ha una quota giornaliera senza costi associata. Una volta che lo script supera questa quota, l'API smetterà di funzionare finché non richiedi dati aggiuntivi o la quota senza costi non viene reintegrata. Puoi monitorare la quota utilizzata dal tuo script aprendo la console API di Google per lo script dalla finestra di dialogo API avanzate. La console API di Google ti consente anche di richiedere una quota aggiuntiva per l'API.

Fatturazione

Alcune API avanzate richiedono il pagamento per l'utilizzo. Questi pagamenti vengono gestiti tramite il progetto Google Cloud associato allo script e non tramite Google Ads. Per maggiori dettagli su come attivare la fatturazione per il progetto Google Cloud dello script, consulta la nostra documentazione.