Le API avanzate negli script Google Ads consentono agli sviluppatori esperti di connettersi a determinate API di Google pubbliche con meno configurazioni rispetto all'utilizzo delle interfacce HTTP. Puoi utilizzare queste API in modo molto simile ai servizi integrati degli script e offrono le stesse funzionalità, 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 modificare di conseguenza le offerte delle tue 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 quanto traffico del tuo sito web o quante vendite provengono da Google Ads, consentendoti di migliorare i tuoi annunci e il tuo sito web. Per scoprire di più sul collegamento degli account Analytics e Google Ads, consulta il nostro Centro assistenza.
- Google BigQuery
- Puoi caricare grandi quantità di dati in Google Cloud Storage e quindi eseguire query su tali dati utilizzando Google BigQuery. Ad esempio, puoi caricare i dati meteo pubblici degli ultimi 10 anni e poi eseguire query sulla temperatura media di una regione in uno script che utilizza queste informazioni per l'aggiustamento delle offerte. Un altro esempio è l'analisi numerica dei dati sul rendimento dell'account nel corso di diversi anni.
- YouTube e YouTube Analytics
- Per prendere decisioni relative alle offerte, puoi recuperare e aggiornare i tuoi video, le tue playlist e così via, nonché i dati sul rendimento dei tuoi video.
- Google Calendar
- Lo script può creare eventi per le attività future (ad esempio, eseguire un report sul rendimento per le tue campagne tra due settimane a partire da oggi) oppure 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 la Google Content API for Shopping in Apps Script. L'API consente agli utenti di Google Merchant Center di caricare e gestire le proprie schede di prodotto, nonché i propri account Merchant Center. Negli script, ciò può essere utile per controllare le schede di prodotto e collegare prodotti specifici ad 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 a partire da oggi) oppure 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 della campagna in Presentazioni Google per pubblicare queste informazioni in un formato presentabile.
Abilita API avanzate
Per visualizzare le API di Google 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.
Successivamente, fai clic sul link Console API di Google per visualizzare nella console la pagina Console API, con il progetto associato al tuo script oppure, 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 nei risultati di ricerca e, nella pagina seguente, scegli Abilita. Se vedi il 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 il tuo script e saranno disponibili nell'elenco di completamento automatico.
API disponibili
Le API disponibili per l'uso sono le seguenti:
| 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 relativa agli snippet di codice per alcuni esempi di utilizzo di queste API.
Considerazioni finali
Ci sono alcuni aspetti da tenere presenti quando si utilizzano le API avanzate.
ID progetto
A ogni script Google Ads è associato un ID progetto (noto anche come numero di progetto) di Google Cloud. Puoi trovare il numero di progetto dello script aprendo la pagina della console API di Google nella 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 l'utente che ha creato lo script viene successivamente rimosso dall'account, a un utente che tenta di accedere allo script verrà richiesto di autorizzare nuovamente lo script e configurare di nuovo le dipendenze dell'API Advanced. Verrà creato anche un nuovo ID progetto sviluppatore di Google e dovrai configurare nuovamente 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 Advanced per quello 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 disponga dell'accesso necessario a tutte le API avanzate in uso e ai dati necessari per lo script. Se utilizzi l'API Google Analytics, assicurati che l'utente che ha autorizzato lo script disponga delle autorizzazioni necessarie per accedere all'account Analytics.
Termini e condizioni
Ogni API avanzata può avere i propri Termini e condizioni che devi accettare quando attivi l'API nella Console API di Google.
Quota
La maggior parte delle API avanzate ha una quota giornaliera senza costi associata. Quando lo script supera questa quota, l'API smetterà di funzionare fino a quando non richiedi ulteriori dati o finché la quota senza costi non viene reintegrata. Puoi monitorare la quota utilizzata dallo script aprendo la console API di Google per lo script dalla finestra di dialogo API avanzate. La console API di Google consente inoltre di richiedere una quota aggiuntiva per l'API.
Fatturazione
Alcune API avanzate richiedono un pagamento per l'utilizzo. Questi pagamenti sono gestiti tramite il progetto Google Cloud Platform associato allo script e non tramite Google Ads. Consulta la nostra documentazione per ulteriori dettagli su come abilitare la fatturazione per il progetto Google Cloud Platform del tuo script.