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 per Google, consentendoti di generare token OAuth per la gestione degli utenti 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 OAuth di Google per evitare la schermata dell'interfaccia utente 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 a eventuali revisioni condotte nell'ambito della procedura di approvazione dei token dello sviluppatore ed è obbligatoria poiché l'ambito dell'API Google Ads è un ambito sensibile.

Non sono previsti costi per la verifica Google, che di solito viene completata in 3-5 giorni lavorativi. Queste norme valgono per tutte le app.

Consigliamo di sottoporre tutte le app alla procedura di verifica OAuth di Google 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 per Google Cloud, devi selezionare un account di fatturazione per il nuovo progetto.

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

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 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 Abilita.

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 tabella seguente evidenzia alcuni attributi chiave e limitazioni di ciascuna combinazione di queste impostazioni. Per ulteriori dettagli, consulta la documentazione della piattaforma Google Cloud.

Tipo di utente	Stato di pubblicazione	Limitazioni
Interna	Test in corso	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 dell'organizzazione Google Cloud associata al progetto. Le autorizzazioni scadono sette giorni dopo il consenso.
Servizio	Test in corso	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 consenso.
Interna	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.
Servizio	In produzione	Disponibile per tutti i progetti. Consente di autorizzare qualsiasi utente con un Account Google.

Il mancato completamento della verifica OAuth di Google genera quanto segue, indipendentemente dal Tipo di utente o dallo Stato di pubblicazione del progetto:

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

• Puoi autorizzare solo 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 di 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 GLI Ambiti.

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

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

   • Fai clic su AGGIUNGI ALLA TABELLA.

   • Aggiungi eventuali altri ambiti richiesti dal tuo progetto e fai clic su AGGIORNA.

   • Fai clic su SALVA E CONTINUA.

5. Se non prevedi di pubblicare il progetto immediatamente, aggiungi l'indirizzo email di ogni account utente che utilizzerai per il test, poi 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 modificare lo stato di pubblicazione da Test a In produzione.

Seleziona un tipo di app

Sono disponibili due tipi di app per l'API Google Ads: desktop o web. Fai riferimento alla tabella seguente per determinare il tipo più appropriato per l'app che vuoi creare:

Scegli questo tipo di app	Se ...
App desktop	Gestisci tutti i tuoi account Google Ads con un unico account amministratore di primo livello. Sei un nuovo utente o vuoi iniziare rapidamente con la configurazione più semplice. La tua app autentica gli utenti Google 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 delle 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 in locale o in remoto. Un flusso desktop richiede il completamento dell'autorizzazione sul computer locale, mentre il flusso web consente il completamento dell'autorizzazione sul server di autorizzazione di Google.

Per ulteriori 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 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, 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. Assegnagli un nome, quindi 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 limitarne l'utilizzo a una porta specifica. Se la porta non è impostata, un client OAuth può reindirizzare a qualsiasi porta.

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

6. Nella pagina di conferma, copia Your Client ID (Il tuo ID client) e Your Client Secret (Il tuo client secret) negli appunti, che ti serviranno durante la configurazione della libreria client. Puoi anche tornare alla pagina delle credenziali in un secondo momento per recuperare questi dettagli.