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

Per accedere ai server OAuth2 di Google sono necessarie le credenziali autenticare e autorizzare gli utenti Google Ads. Queste credenziali identificano su Google, consentendoti di generare token OAuth per la gestione di Google Ads utenti. 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à di sottoporsi a una richiesta Google OAuth di verifica per evitare una schermata di interfaccia utente non verificata per 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 come parte del processo di approvazione dei token dello sviluppatore, ed è obbligatorio poiché l'ambito dell'API Google Ads è un ambito di archiviazione.

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 eseguire la procedura di verifica OAuth di Google per tutte le app non appena il più 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:

  1. Apri la libreria API nella console API di Google. Se richiesto, seleziona progetto o crearne uno nuovo. Nella Libreria API sono elencate tutte le opzioni disponibili API 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 del progetto e Stato di pubblicazione. La seguente tabella evidenzia alcuni attributi chiave limitazioni di ogni combinazione di queste impostazioni. Per ulteriori dettagli, consulta la piattaforma Google Cloud documentazione.

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

Mancato completamento della procedura Google OAuth verifica genera quanto segue, indipendentemente dal Tipo di utente o dalla Pubblicazione del tuo progetto:

  1. Apri l'app Pagina della schermata per il consenso e seleziona il tuo progetto dal 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. Clic Al termine, 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 manualmente ambiti:

      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 ciascun account utente che utilizzerai per i test, fai clic su SALVA E CONTINUA

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

Dopo aver testato la tua richiesta e la procedura di autorizzazione, puoi torna alla dashboard e fai clic su PUBBLICA APP per modificarne la scheda 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. Consulta le la seguente tabella per determinare il tipo più appropriato per l'app che vuoi per creare:

Scegli questo tipo di app Se ...
App desktop
  • Gestisci tutti i tuoi account Google Ads con un unico livello superiore. account amministratore.
  • Sei un nuovo utente o vuoi iniziare rapidamente con il modo più semplice configurazione.
  • 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 per: accedere ai dati del proprio account Google Ads.
  • Volete generare facilmente più credenziali di autorizzazione, account di terze parti.
  • La tua app richiede URL di callback. Gli URL di callback non sono supportati in flusso di app per desktop.

Per ulteriori dettagli, consulta la documentazione di Google Identity Platform OAuth 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 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, quindi seleziona OAuth l'ID client.

    1. Se non hai configurato una schermata per il consenso OAuth per questo progetto ti verrà chiesto di farlo ora. Clic 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. Clic Al termine, 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'applicazione URI di reindirizzamento.

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

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

  6. Copia Your Client ID (Il tuo ID cliente) e Your Client Secret (Il tuo client secret) nella pagina di conferma. negli appunti, perché ti serviranno durante la configurazione libreria. Puoi anche tornare alla pagina delle credenziali in un secondo momento per recuperarle i dettagli.