Le API avanzate negli script Google Ads consentono agli sviluppatori esperti di connettersi a determinate API Google pubbliche con una configurazione inferiore rispetto all'utilizzo delle relative interfacce HTTP. Puoi utilizzare queste API in modo molto simile ai servizi integrati degli script e offrono le stesse comodità, come il completamento automatico e l'autorizzazione automatica.
Possibili utilizzi delle API avanzate
- Google Analytics
- Puoi utilizzare Google Analytics per monitorare il traffico verso il tuo sito web e aggiustare di conseguenza le offerte della campagna. 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 proviene da Google Ads e a migliorare gli annunci e il sito web. Puoi approfondire il collegamento degli account Analytics e Google Ads nel nostro Centro assistenza.
- Google BigQuery
- Puoi caricare grandi quantità di dati in Google Cloud Storage, quindi eseguire query sui dati utilizzando Google BigQuery. Ad esempio, puoi caricare i dati meteorologici pubblici degli ultimi 10 anni e poi eseguire una query per la temperatura media di una regione in uno script che utilizza queste informazioni per regolare le offerte. Un altro utilizzo è eseguire calcoli sui dati sul rendimento del tuo account per diversi anni.
- 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 in merito alle offerte.
- 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).
- Contenuti Shopping
- Il tuo script può utilizzare l'API Content for Shopping di Google in Apps Script. Questa API consente agli utenti di Google Merchant Center di caricare e gestire le schede di prodotto e i propri account Merchant Center. Negli script, questo può essere utile per controllare le schede di prodotto e collegare prodotti specifici a annunci specifici.
- Google Tasks
- Lo script può creare un elenco di promemoria per le attività future (ad esempio, eseguire un report sul rendimento per le campagne tra due settimane da oggi) o eseguire azioni in base a una voce creata nell'elenco di promemoria (ad esempio, attivare una campagna in una data specifica).
- Presentazioni Google
- Lo script può esportare i dettagli o le statistiche delle campagne in Google Presentazioni per pubblicare queste informazioni in un formato presentabile.
Abilita 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 attivare.
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 successiva scegli Attiva. Se vedi un pulsante Disattiva, significa che l'API è già attivata. Ripeti questa azione per ogni API da attivare.
Per visualizzare l'elenco delle API abilitate per il progetto, seleziona la pagina Dashboard. Verifica che tutte le API avanzate che vuoi utilizzare per lo script siano elencate.
Ora chiudi la finestra di dialogo API avanzate per tornare all'editor. Le nuove API verranno attivate per lo script e saranno disponibili nell'elenco del completamento automatico.
API disponibili
Puoi utilizzare le seguenti API:
| Nome API | Documentazione |
|---|---|
| Google Analytics | https://developers.google.com/apps-script/advanced/analytics |
| Google BigQuery | https://developers.google.com/apps-script/advanced/bigquery |
| Google Calendar | https://developers.google.com/apps-script/advanced/calendar |
| Presentazioni Google | https://developers.google.com/apps-script/advanced/slides |
| Google Tasks | https://developers.google.com/apps-script/advanced/tasks |
| Contenuti Shopping | 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 |
Puoi anche consultare la nostra pagina degli snippet di codice per alcuni esempi su come utilizzare queste API.
Considerazioni finali
Quando utilizzi le API avanzate, tieni presente alcuni aspetti.
ID progetto
A ogni script Google Ads è associato un ID progetto (noto anche come numero di progetto) della piattaforma Google Cloud. Puoi trovare il numero del 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 è associato all'utente che ha creato lo script Google Ads. Se in un secondo momento l'utente che ha creato lo script viene rimosso dall'account, a un utente che tenta di accedere allo script verrà chiesto di riautorizzarlo 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 lo script.
Autorizzazioni
Quando accede alle API, uno script utilizza le autorizzazioni dell'utente che lo ha autorizzato. Assicurati che l'utente che ha autorizzato lo script abbia accesso obbligatorio a tutte le API avanzate in uso, nonché ai dati di cui lo script ha bisogno. Se utilizzi l'API Google Analytics, assicurati che l'utente che ha autorizzato lo script disponga delle autorizzazioni necessarie per l'account Analytics a cui si accede.
Termini e condizioni
Ognuna delle API avanzate potrebbe avere i propri Termini e condizioni che devi accettare quando attivi l'API nella console API di Google.
Quota
Alla maggior parte delle API avanzate è associata una quota giornaliera senza costi. 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 script aprendo la console API di Google per lo script dalla finestra di dialogo API avanzate. La console API di Google ti offre anche un modo per richiedere una quota aggiuntiva per l'API.
Fatturazione
Per alcune API avanzate è previsto un pagamento per l'utilizzo. Questi pagamenti vengono gestiti tramite il progetto Google Cloud associato allo script e non tramite Google Ads. Consulta la nostra documentazione per ulteriori dettagli su come attivare la fatturazione per il progetto Google Cloud Platform dello script.