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

Per autenticare e autorizzare gli utenti di Google Ads, sono necessarie le credenziali per accedere ai server OAuth2 di Google. Queste credenziali identificano la tua app per Google, consentendoti di generare token OAuth per gestire gli utenti di Google Ads. L'accesso alle credenziali OAuth2 di Google viene gestito dalla console API di Google.

Guarda questo video per scoprire alcune best practice per i progetti Cloud

Verifica OAuth di Google

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

Questa verifica è indipendente e aggiuntiva a eventuali revisioni condotte nell'ambito della procedura di approvazione dei token sviluppatore ed è obbligatoria poiché l'ambito dell'API Google Ads è un ambito sensibile.

La verifica di Google non ha costi e in genere viene completata entro 3-5 giorni lavorativi. Queste norme si applicano a tutte le app.

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

Crea 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 attivato la fatturazione, ad esempio per Google Cloud, devi selezionare un account di fatturazione per il nuovo progetto.

L'utilizzo dell'API Google Ads non prevede alcun costo, ma è prevista una quota per il numero totale di progetti Cloud. In alternativa, puoi creare un nuovo Account Google che include una quota di progetto senza costi.

Abilita l'API Google Ads nel tuo 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 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 poi fai clic sul pulsante Abilita.

Scegli un tipo di utente e uno stato di pubblicazione

Dopo aver attivato l'API, devi specificare il tipo di utente e stato di pubblicazione del progetto. La tabella seguente mette in evidenza alcuni attributi chiave e limitazioni di ogni combinazione di queste impostazioni. Per maggiori 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. Limite di massimo 100 utenti di test elencati nella schermata per il consenso OAuth. Gli utenti di test devono essere utenti interni dell'organizzazione Google Cloud associata al progetto. Le autorizzazioni scadono sette giorni dopo il momento in cui è stato dato il consenso.
Esterno	Test	Disponibile per tutti i progetti. Limite di massimo 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 in cui è stato dato il 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.

Se non completi la verifica OAuth di Google, si verifica quanto segue, indipendentemente dal tipo di utente o dallo stato di pubblicazione del tuo progetto:

• Durante la procedura di autorizzazione, agli utenti viene presentata una schermata della UI non verificata.

• Puoi autorizzare solo 100 utenti.

Configura la schermata per il consenso OAuth

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

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

3. Compila il modulo della schermata del consenso. Se necessario, puoi modificarlo in un secondo momento. Al termine, fai clic su SALVA E CONTINUA.

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

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

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

   • Fai clic su AGGIUNGI ALLA TABELLA.

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

   • Fai clic su SALVA E CONTINUA.

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

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

Dopo aver testato l'applicazione e la procedura di autorizzazione, puoi tornare alla dashboard e fare clic su PUBBLICA APP per modificare lo stato di pubblicazione da Test a In produzione.

Seleziona un tipo di app

Per l'API Google Ads sono disponibili due opzioni di tipo di app: desktop o web. Consulta la tabella seguente per determinare il tipo più adatto per l'app che vuoi creare:

Scegli questo tipo di app	Se…
App desktop	Gestisci tutti i tuoi account Google Ads utilizzando un unico account amministratore di primo livello. È la prima volta che utilizzi la piattaforma o vuoi iniziare rapidamente con la configurazione più semplice. La tua app autentica gli utenti Google solo da un computer.
App web	Vuoi autenticarti come utente che può concedere alla tua app l'autorizzazione ad accedere ai dati del proprio 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 sta nel fatto che l'autorizzazione OAuth viene completata localmente o da remoto. Un flusso da computer richiede che l'autorizzazione venga completata sulla macchina locale, mentre il flusso web consente di completare l'autorizzazione sul server di autorizzazione di Google.

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

Crea un ID client e un client secret

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

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

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

   1. Se non hai ancora 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, puoi modificarlo 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 nei nostri 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 app desktop, utilizzerai comunque un reindirizzamento IP loopback, ma l'URI non è configurato esplicitamente nella console Cloud.

6. Nella pagina di conferma, copia Il tuo ID client e Il tuo client secret nei tuoi appunti, poiché ti serviranno per configurare la libreria di client. Puoi anche tornare alla pagina delle credenziali in un secondo momento per recuperare questi dettagli.