Configura l'autorizzazione

L'API Search Ads 360 richiede che tutte le richieste specifichino un token di accesso OAuth 2.0 per l'autenticazione. Puoi seguire qualsiasi flusso di lavoro di autenticazione OAuth 2.0 standard per generare il token e passarlo all'API Search Ads 360. Consigliamo il flusso di lavoro descritto di seguito perché è adatto per caricamenti delle conversioni e download dei report completamente automatici.

Per alternative al flusso di lavoro descritto di seguito, consulta Utilizzo di OAuth 2.0 per le applicazioni installate o Utilizzo di OAuth 2.0 per le applicazioni da server a server. Se utilizzi un flusso di lavoro alternativo, specifica il seguente valore come parametro scope quando richiedi un codice di autorizzazione OAuth 2.0:
https://www.googleapis.com/auth/doubleclicksearch
Se segui il percorso server-to-server, aggiungi l'account di servizio come utente di Search Ads 360.

Flusso di lavoro di autorizzazione consigliato

1. Vai alla console API di Google e seleziona il tuo progetto.

   Se non hai ancora creato un progetto della console API di Google e le credenziali OAuth, segui le istruzioni riportate in Creare un progetto della console API di Google e le credenziali OAuth per il client.

   Per trovare l'ID client OAuth e il client secret del tuo progetto:

   1. Apri la pagina Credenziali.
   2. Nella colonna Nome, fai clic sul nome del client OAuth.
   3. L'ID client e il client secret sono elencati nella pagina.
2. Apri un browser web e accedi a Google con un Account Google che disponga dell'autorizzazione per accedere ai dati in Search Ads 360.

   Si tratta dell'Account Google che il client API utilizzerà per autenticarsi in Search Ads 360. Se il proprietario dell'Account Google lascia la tua azienda e rimuovi l'accesso a Search Ads 360 dall'account, dovrai ripetere questo flusso di lavoro di autorizzazione e specificare un Account Google diverso.

3. Ottieni un token di aggiornamento richiamando lo script dell'utilità di Search Ads 360 come segue:

   sa360Api.py --login

   Lo script illustra la procedura di utilizzo dell'ID client e del secret OAuth per ottenere un token di aggiornamento. Il token di aggiornamento è valido solo per l'Account Google a cui hai eseguito l'accesso nel passaggio precedente.

   Nell'ambito di questa procedura, lo script genera un URL e ti invita a visitarlo in un browser web.

4. Quando il browser ti chiede di consentire l'accesso del client OAuth ai dati di Search Ads 360, assicurati che venga visualizzato l'Account Google a cui hai eseguito l'accesso in precedenza. Se hai eseguito l'accesso a più Account Google, potresti visualizzare un account diverso.
   

   Al termine del processo, lo script sa360Api.py genera una stringa delimitata da virgole. Il primo valore è l'ID cliente che hai fornito, il secondo è il client secret che hai fornito e il terzo è il token di aggiornamento. Nell'output dell'esempio seguente, il token di aggiornamento è in testo in grassetto:
   123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw

5. Memorizza l'ID cliente, il client secret e il token di aggiornamento in un database di backend o in un'altra posizione sicura accessibile alla tua applicazione.

   Conserva l'intera stringa delimitata da virgole in una posizione comoda se prevedi di utilizzare sa360Api.py per inviare richieste JSON di esempio all'API Search Ads 360. Dovrai passare l'intera stringa come parametro ogni volta che richiami lo script.

6. Aggiungi alla tua applicazione il codice che esegue le seguenti operazioni:
   1. Utilizza l'ID client, il client secret e il token di aggiornamento per ottenere un nuovo token di accesso OAuth 2.0.
   2. Invia richieste all'API Search Ads 360 utilizzando il token di accesso aggiornato.

   Se utilizzi le librerie client, la sezione successiva, Configura l'applicazione, descrive come aggiungere questo codice di autorizzazione alla tua applicazione.

   Se non utilizzi una delle librerie client, consulta l'articolo sull'utilizzo di OAuth 2.0 per le applicazioni installate per suggerimenti su come ottenere un nuovo token di accesso.