Configurare un progetto della console API di Google per l'API Google Ads

Le credenziali per accedere ai server OAuth2 di Google sono necessarie per autenticare e autorizzare gli utenti Google Ads. Queste credenziali identificano la tua app su Google e ti consentono di generare token OAuth per gestire gli utenti di Google Ads. L'accesso alle credenziali OAuth2 di Google è gestito dalla console API di Google.

Guarda questo video per scoprire alcune best practice relative ai progetti Cloud

Verifica Google OAuth

Qualsiasi app Google Cloud utilizzata per ottenere le credenziali per l'ambito dell'API Google Ads dovrà essere sottoposta a una verifica OAuth di Google per evitare di visualizzare una schermata UI non verificata per gli utenti. In questo contesto, un'app è definita come un ID client OAuth 2.0 univoco in Google Cloud.

Questa verifica è indipendente e si aggiunge alle revisioni condotte nell'ambito della procedura di approvazione dei token sviluppatore ed è obbligatoria, in quanto l'ambito dell'API Google Ads è un ambito sensibile.

La verifica di Google è senza costi, che in genere viene completata entro 3-5 giorni lavorativi. Queste norme si applicano a tutte le app.

Consigliamo di sottoporre tutte le app alla procedura di verifica Google OAuth il prima possibile per evitare interruzioni dell'attività.

Creare un progetto

Vai alla console dell'API di Google. Fai clic su Crea progetto, inserisci un nome e fai clic su Crea.

Punto chiave: se hai abilitato la fatturazione, ad esempio Google Cloud, devi selezionare un account di fatturazione per il nuovo progetto.

L'utilizzo dell'API Google Ads è senza costi, ma è prevista una quota per il numero totale di progetti Cloud. In alternativa, puoi registrarti per un nuovo Account Google che includa una quota di progetto senza costi.

Attivare l'API Google Ads nel progetto

Per attivare l'API Google Ads per il tuo progetto:

1. Apri la libreria API nella console API di Google. Se richiesto, seleziona il tuo progetto o creane uno nuovo. La libreria API elenca tutte le API disponibili, raggruppate per famiglia di prodotti e popolarità.

2. Utilizza la ricerca per trovare l'API Google Ads se non è visibile nell'elenco.

3. Seleziona l'API Google Ads e fai clic sul pulsante Attiva.

Scegli un tipo di utente e lo stato di pubblicazione

Dopo aver abilitato l'API, devi specificare il tipo di utente e lo stato di pubblicazione del progetto. La seguente tabella evidenzia alcuni attributi chiave e limitazioni di ogni combinazione di queste impostazioni. Per ulteriori dettagli, consulta la documentazione della piattaforma Google Cloud.

Tipo di utente	Stato di pubblicazione	Limitazioni
Interno	Test	Disponibile solo per i progetti associati a un'organizzazione Google Cloud. Limitato a un massimo di 100 utenti di test elencati nella schermata per il consenso OAuth. Gli utenti di test devono essere utenti interni nell'organizzazione Google Cloud associata al progetto. Le autorizzazioni scadono sette giorni dopo il momento del consenso.
Esterno	Test	Disponibile per tutti i progetti. Limitato a un massimo di 100 utenti di test elencati nella schermata per il consenso OAuth. Gli utenti di test possono essere qualsiasi utente con un Account Google. Le autorizzazioni scadono sette giorni dopo il momento del consenso.
Interno	In produzione	Disponibile solo per i progetti associati a un'organizzazione Google Cloud. Consente di autorizzare qualsiasi utente all'interno dell'organizzazione Google Cloud associata al progetto.
Esterno	In produzione	Disponibile per tutti i progetti. Consente di autorizzare qualsiasi utente con un Account Google.

Il mancato completamento della verifica OAuth di Google comporta quanto segue, indipendentemente dal tipo di utente o dallo stato di pubblicazione del progetto:

• Durante il processo di autorizzazione, agli utenti viene mostrata una schermata UI non verificata.

• Puoi autorizzare al massimo 100 utenti.

Configurare la schermata per il consenso OAuth

1. Apri la pagina Schermata di consenso e seleziona il tuo progetto nel menu a discesa nella parte superiore della pagina.

2. Seleziona il Tipo di utente e fai clic su CREA.

3. Compila il modulo della schermata per il consenso. Se necessario, potrai modificare questa opzione in un secondo momento. Al termine, fai clic su SALVA E CONTINUA.

4. Nella pagina successiva, fai clic su AGGIUNGI O RIMUOVI GLI AMBITI.

   • Scorri verso il basso e inserisci quanto segue nel campo in Aggiungi ambiti manualmente:

     https://www.googleapis.com/auth/adwords
     

   • Fai clic su AGGIUNGI A TABELLA.

   • Aggiungi eventuali altri ambiti richiesti dal progetto, poi fai clic su AGGIORNA.

   • Fai clic su SALVA E CONTINUA.

5. Se non prevedi di pubblicare il progetto immediatamente, aggiungi l'indirizzo email di ciascun account utente che utilizzerai per i test, quindi fai clic su SALVA E CONTINUA.

6. Esamina la pagina di riepilogo e fai clic su TORNA ALLA DASHBOARD.

Dopo aver testato l'applicazione e il processo di autorizzazione, puoi tornare alla dashboard e fare clic su PUBBLICA APP per modificarne lo Stato di pubblicazione da Test a In produzione.

Seleziona un tipo di app

Esistono due tipi di app per l'API Google Ads: Desktop o Web. Fai riferimento alla seguente tabella per determinare il tipo più appropriato per l'app che vuoi creare:

Scegli questo tipo di app	Se ...
App desktop	Stai gestendo tutti i tuoi account Google Ads utilizzando un unico account amministratore di primo livello. Se sei un nuovo utente o vuoi iniziare rapidamente con la configurazione più semplice, La tua app autenticherà gli utenti Google solo da un solo computer.
App web	Vuoi autenticarti come utente che può concedere alla tua app l'autorizzazione ad accedere ai dati del suo account Google Ads. Vuoi generare facilmente più credenziali di autorizzazione, ad esempio per gestire account di terze parti. La tua app richiede URL di callback. Gli URL di callback non sono supportati nel flusso dell'app desktop.

Punto chiave: puoi comunque scegliere il flusso dell'app desktop anche se stai sviluppando un'app da eseguire su un server. La differenza è se l'autorizzazione OAuth viene completata localmente o da remoto. Un flusso desktop richiede il completamento dell'autorizzazione sulla macchina locale, mentre il flusso web consente il completamento dell'autorizzazione sul server di autorizzazione di Google.

Per ulteriori dettagli, consulta la documentazione OAuth di Google Identity Platform per app desktop o app web.

Crea un ID client e un client secret

Una volta determinato il tipo di app, segui le istruzioni riportate di seguito per generare l'ID client OAuth2 e il client secret:

1. Apri la pagina Credenziali. Seleziona un progetto creato in precedenza o creane uno nuovo.

2. Nella schermata Credenziali, fai clic su CREA CREDENZIALI, quindi seleziona ID client OAuth.

   1. Se non hai mai configurato una schermata per il consenso OAuth per questo progetto, ti verrà chiesto di farlo ora. Fai clic su CONFIGURA SCHERMATA DI CONSENSO.

      1. Seleziona il tipo di utente e fai clic su CREA.

      2. Compila il modulo iniziale. Se necessario, potrai modificare questa opzione in un secondo momento. Al termine, fai clic su Salva.

   2. Torna a Credenziali > CREA CREDENZIALI > ID client OAuth per continuare.

3. Seleziona App desktop o Applicazione web come tipo di app, a seconda del caso d'uso.

4. Assegna un nome e fai clic su Crea.

5. Se il tipo di client è Applicazione web, aggiungi almeno un URI di reindirizzamento autorizzato.

   Per i test locali compatibili con la configurazione predefinita negli esempi di libreria client, utilizza http://127.0.0.1.

   Nota: puoi aggiungere un numero di porta all'URI di reindirizzamento per limitare l'utilizzo a una porta specifica. Se la porta non è impostata, un client OAuth può reindirizzare a qualsiasi porta.

   Per i client di app desktop, utilizzerai comunque un reindirizzamento IP di loop, ma l'URI non è configurato esplicitamente nella console Cloud.

6. Nella pagina di conferma, copia negli appunti i campi Il tuo ID client e Il tuo client secret, poiché ti serviranno durante la configurazione della libreria client. Puoi anche tornare alla pagina delle credenziali in un secondo momento per recuperare questi dettagli.