Le API avanzate negli script Google Ads consentono agli sviluppatori di connettersi a determinate API di Google pubbliche con meno impostazioni rispetto alle relative interfacce HTTP. Puoi utilizzare queste API in modo molto simile ai servizi integrati degli script, con gli stessi vantaggi, 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
- Nota: l'API avanzata
Analyticsnella finestra di dialogo API avanzate ha come target l'API Universal Analytics v3 disattivata e le richieste non vanno a buon fine. Gli script Google Ads non supportano i servizi avanzatiAnalyticsDataoAnalyticsAdmindi Google Analytics 4. Per eseguire query sui dati di Google Analytics 4 da uno script, invia richieste HTTPS all'API Google Analytics Data utilizzando il servizioUrlFetchAppe OAuth 2.0. Puoi anche collegare una proprietà Google Analytics 4 al tuo account Google Ads per condividere direttamente i dati sulle conversioni web e di app. Per istruzioni sulla configurazione, consulta la guida alla configurazione di Analytics. - Google BigQuery
- Puoi caricare grandi quantità di dati in Google Cloud Storage, quindi 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 l'elaborazione dei dati sul rendimento del tuo account nel corso di 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 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 di promemoria (ad esempio, attivare una campagna in una data specifica).
- API Merchant
- Il tuo script può utilizzare l'API Merchant per caricare e gestire le schede di prodotto e gli account Google Merchant Center. Negli script, questo può essere utile per controllare le schede di prodotto e collegare prodotti specifici ad annunci specifici. L'API Merchant dispone di API secondarie che possono essere attivate 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 per lo shopping
- Lo script può utilizzare l'API Google Content for Shopping per caricare e gestire le schede di prodotto e gli account Google Merchant Center. Negli script, questo 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 relative alle offerte.
Abilita 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 presente quando si lavora con 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 avanzate, uno script utilizza le autorizzazioni dell'utente che lo ha autorizzato. L'utente autorizzante deve disporre dell'accesso richiesto a tutti i dati necessari allo script. Ad esempio, per utilizzare l'API avanzata BigQuery, l'utente autorizzante deve disporre delle autorizzazioni richieste per il progetto Google Cloud e il set di dati BigQuery di destinazione.
Considerazioni per gli script precedenti a maggio 2019
Per gli script creati prima di maggio 2019, potrebbe essere necessario attivare 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.
Abilita le API avanzate
Per gli script precedenti al 2019, dovrai attivare manualmente ogni API avanzata che vuoi utilizzare nello script:
- Fai clic sul pulsante API avanzate. Nella finestra di dialogo seguente, fai clic sul link alla console Google Cloud.
- 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.
- Seleziona l'API dai risultati di ricerca e fai clic sul pulsante "Abilita" nella pagina successiva.
Se l'utente che ha creato lo script viene rimosso dall'account in un secondo momento, a ogni nuovo utente che tenta di accedere allo script verrà chiesto di attivare nuovamente le dipendenze API avanzate e di autorizzare nuovamente lo script.