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.
Attivare l'API Google Ads nel progetto
Per attivare l'API Google Ads per il tuo progetto:
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à.
Utilizza la ricerca per trovare l'API Google Ads se non è visibile nell'elenco.
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 |
|
Servizio | Test in corso |
|
Interna | In produzione |
|
Servizio | In produzione |
|
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
Apri la pagina Schermata di consenso e seleziona il tuo progetto nel menu a discesa nella parte superiore della pagina.
Seleziona il Tipo di utente e fai clic su CREA.
Compila il modulo della schermata di consenso. Se necessario, puoi modificarlo in un secondo momento. Al termine, fai clic su SALVA E CONTINUA.
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.
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.
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 |
|
App web |
|
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:
Apri la pagina Credenziali. Seleziona un progetto creato in precedenza o creane uno nuovo.
Nella schermata Credenziali, fai clic su CREA CREDENZIALI, quindi seleziona ID client OAuth.
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.
Seleziona il tipo di utente e fai clic su CREA.
Compila il modulo iniziale. Se necessario, puoi modificarlo in un secondo momento. Al termine, fai clic su Salva.
Torna a Credenziali > CREA CREDENZIALI > ID client OAuth per continuare.
Seleziona App desktop o Applicazione web come tipo di app, a seconda del caso d'uso.
Assegnagli un nome, quindi fai clic su Crea.
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
.Per i client dell'app desktop, utilizzerai comunque un reindirizzamento IP di loopback, ma l'URI non è configurato esplicitamente nella console Cloud.
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.