L'API Search Ads 360 Reporting precedente non sarà più disponibile a partire dal 30 giugno 2024. Tieni presente che l'API Search Ads 360 Conversion non è interessata e continuerà a essere supportata. Tutte le nuove implementazioni di reporting devono utilizzare la nuova API Search Ads 360 Reporting.

A partire da aprile 2024, verrà restituito un errore non supportatoApiVersion quando si richiede un report. Consulta i dettagli qui.

Ti consigliamo inoltre di eseguire la migrazione delle implementazioni esistenti di Search Ads 360 alla nuova API. Per saperne di più, consulta la guida introduttiva e la guida alla migrazione della nuova API Search Ads 360 Reporting.

Questa pagina è stata tradotta dall'API Cloud Translation.

Configura 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 trasferirlo all'API Search Ads 360. Consigliamo il flusso di lavoro descritto di seguito perché è adatto ai caricamenti di conversioni completamente automatici e ai download dei report.

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 server-server. Se usi 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 la route server-server, aggiungi l'account di servizio come utente Search Ads 360.

Flusso di lavoro di autorizzazione consigliato

Vai alla console API di Google e seleziona il tuo progetto.
Se non hai ancora creato un progetto nella console API di Google e le credenziali OAuth, segui le istruzioni in Creare un progetto nella console API di Google e le credenziali OAuth per il tuo client.

Per trovare l'ID client e il secret OAuth del tuo progetto, segui questi passaggi:
1. Apri la pagina Credenziali.
2. Nella colonna Nome, fai clic sul nome del tuo client OAuth.
3. L'ID client e il secret sono elencati nella pagina.
Apri un browser web e accedi a Google con un Account Google che ha l'autorizzazione ad accedere ai dati in Search Ads 360.
Si tratta dell'Account Google che il tuo client API utilizzerà per l'autenticazione con Search Ads 360. Se il titolare dell'Account Google lascia l'azienda e rimuovi l'accesso a Search Ads 360 dall'account, devi ripetere questo flusso di lavoro di autorizzazione e specificare un Account Google diverso.
Recupera un token di aggiornamento richiamando lo script utilità di Search Ads 360 come indicato di seguito:
sa360Api.py --login

Lo script ti guiderà nella 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 durante il passaggio precedente.
Nell'ambito di questo processo, lo script genera un URL e indica di visitarlo in un browser web.
Quando il browser ti chiede di consentire l'accesso dei 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 restituisce una stringa delimitata da virgole. Il primo è l'ID client che hai fornito, il secondo è il client secret che hai fornito e il terzo è il token di aggiornamento. Nell'output di esempio seguente, il token di aggiornamento è in grassetto:
123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw
Archivia l'ID client, il client secret e aggiorna il token 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 pratica se prevedi di utilizzare sa360Api.py per inviare richieste JSON di esempio all'API Search Ads 360. Passerai l'intera stringa come parametro ogni volta che richiami lo script.
Aggiungi codice all'applicazione con le seguenti operazioni:
1. Utilizza l'ID client, il client secret e aggiorna il token per ottenere un nuovo token di accesso OAuth 2.0.
2. Inviare le richieste all'API Search Ads 360 utilizzando il nuovo token di accesso.
Se utilizzi le librerie client, nella sezione successiva, Configura l'applicazione, viene descritto come aggiungere questo codice di autorizzazione alla tua applicazione.

Se non utilizzi una delle librerie client, consulta la pagina Utilizzo di OAuth 2.0 per le applicazioni installate per suggerimenti su come ottenere un nuovo token di accesso.