Configura un progetto nella console API di Google

Per creare le credenziali OAuth 2.0, configurare una schermata per il consenso degli utenti e attivare l'API Google Ads per la tua app, è necessario un progetto della console API di Google.

Le credenziali sono necessarie per l'autenticazione e l'autorizzazione degli utenti Google Ads da parte dei server di Google. che consentono di generare token OAuth da usare nelle chiamate all'API.

Seleziona o crea un progetto della console API di Google

Se hai già un progetto della console API di Google e vuoi utilizzarlo per creare credenziali, puoi passare direttamente a Creare un ID client e un client secret.

Per creare un progetto:

  • Vai alla console API di Google.
  • Fai clic su Crea progetto
  • Inserisci un nome o accetta il suggerimento generato
  • Conferma o modifica gli eventuali campi rimanenti
  • Fai clic su Crea

Se hai abilitato la fatturazione, seleziona un account di fatturazione per il nuovo progetto. Non è previsto alcun costo per l'utilizzo dell'API Google Ads, ma è prevista una quota per il numero totale di progetti Cloud.

Se utilizzi un progetto della console API di Google esistente e hai già configurato una schermata per il consenso OAuth, puoi saltare questo passaggio e modificare la schermata per il consenso aggiungendo l'ambito OAuth 2.0 dell'API Google Ads.

Quando utilizzi OAuth 2.0 per l'autorizzazione, Google mostra all'utente una schermata per il consenso, che include un riepilogo del progetto, i relativi criteri e gli ambiti di autorizzazione dell'accesso richiesti. La configurazione della schermata di consenso OAuth dell'app definisce cosa viene mostrato agli utenti e ai revisori di app e registra la tua app per poterla pubblicare in un secondo momento.

  1. Apri la pagina Schermata 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.
  5. Scorri verso il basso e inserisci quanto segue nel campo in Aggiungi ambiti manualmente:

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

  6. Fai clic su AGGIUNGI A TABELLA.
  7. Aggiungi eventuali altri ambiti che potrebbero servire al progetto, quindi fai clic su AGGIORNA.
  8. Fai clic su SALVA E CONTINUA.
  9. Se non prevedi di pubblicare il progetto immediatamente, aggiungi l'indirizzo email di ciascun account utente che potresti utilizzare per i test, quindi fai clic su SALVA E CONTINUA.
  10. Esamina la pagina di riepilogo e fai clic su TORNA ALLA DASHBOARD.
  1. Apri la pagina Schermata consenso e seleziona il tuo progetto nel menu a discesa nella parte superiore della pagina.
  2. Fai clic su MODIFICA APP.
  3. Fai clic su SALVA E CONTINUA nel modulo della schermata per il consenso OAuth.
  4. Nella pagina successiva, fai clic su AGGIUNGI O RIMUOVI GLI AMBITI.
  5. Scorri verso il basso e inserisci quanto segue nel campo in Aggiungi ambiti manualmente:

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

  6. Fai clic su AGGIUNGI A TABELLA.
  7. Fai clic su SALVA E CONTINUA.
  8. Fai clic su SALVA E CONTINUA nel modulo Utenti di test.
  9. Esamina la pagina di riepilogo e fai clic su TORNA ALLA DASHBOARD.

Crea un ID client e un client secret

Puoi saltare questo passaggio se utilizzi un progetto della console API di Google esistente in cui sono già stati generati un ID client e un secret.

Dopo aver determinato il tipo di app, segui le istruzioni riportate di seguito per generare l'ID client OAuth 2.0 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.

    • Se non hai già configurato una schermata per il consenso OAuth per questo progetto, fai clic su CONFIGURA SCHERMATA DI CONSENSO.

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

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

    • 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. Questa guida utilizza App desktop come tipo di app.

  4. Inserisci il nome dell'app e fai clic su Crea.

  5. Nella pagina di conferma, copia Il tuo ID client e Il tuo client secret negli appunti per configurare la libreria client in un secondo momento. Inoltre, scarica le credenziali in formato JSON in un file denominato credentials.json.

Attivare l'API Google Ads nel progetto

Per attivare l'API Google Ads nel 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.