La tua prima app: prerequisiti

Prima di poter iniziare a scrivere la tua prima applicazione client, se non l'hai ancora fatto, devi completare alcune operazioni.

Creare un Account Google e ottenere le autorizzazioni di Search Ads 360

Per utilizzare l'API Search Ads 360, devi disporre di un Account Google e delle autorizzazioni appropriate concesse all'account da Search Ads 360:

  1. Se non hai ancora un Account Google, creane uno.

  2. Chiedi a un gestore agenzia di Search Ads 360 di creare un utente Search Ads 360 per il tuo Account Google.

    Per scaricare i report, devi disporre dell'autorizzazione di visualizzazione per gli inserzionisti con cui lavorerai.

    Per aggiungere o modificare le conversioni, devi disporre dell'autorizzazione di modifica per gli inserzionisti con cui collaborerai. In una configurazione Floodlight condivisa, devi disporre dell'autorizzazione di modifica per ogni inserzionista secondario in cui vuoi caricare le conversioni. Non occorre l'accesso all'inserzionista principale né a quelli secondari in cui non stai caricando le conversioni. Se utilizzi gli ID clic per attribuire le conversioni alle visite, assicurati di disporre dell'accesso in modifica all'inserzionista che ha generato l'ID clic. Se specifichi un ID clic da un inserzionista a cui non hai accesso in modifica, la richiesta non andrà a buon fine.

    Il Gestore agenzia può impostare il tuo account come Utente inserzionista con accesso a inserzionisti specifici oppure configurare il tuo account con un livello di accesso superiore, ad esempio Utente agenzia con accesso a tutti gli inserzionisti dell'agenzia.

Attivare il servizio API Conversion

Se vuoi caricare i dati sulle conversioni, un utente Search Ads 360 con i privilegi di gestore agenzia deve accedere all'interfaccia utente di Search Ads 360 e attivare il servizio API Conversion. Per istruzioni, consulta il Centro assistenza Search Ads 360.

Crea un progetto nella console API di Google e le credenziali OAuth per il tuo client

  1. Avvia lo strumento di configurazione della console API di Google.
    Lo strumento di configurazione ti guiderà nella creazione di un progetto (o nell'utilizzo di un progetto esistente), nell'attivazione dell'API Search Ads 360 e nella creazione delle credenziali OAuth 2.0.
  2. Nella pagina Registra la tua applicazione, seleziona un progetto esistente o Crea un progetto. Poi fai clic su Continua.
  3. Dopo che la console API di Google ha attivato l'API Search Ads 360, fai clic sul pulsante Vai alle credenziali.
  4. Nella pagina Crea credenziali, inserisci le informazioni seguenti:
    • Quale API stai utilizzando?: API di Search Ads 360
    • A quali dati accederai?: Dati utente
  5. Fai clic sul pulsante Avanti.

    Ora lo strumento di configurazione ti offre la possibilità di creare un ID client OAuth 2.0.

  6. Segui il resto della procedura nello strumento di configurazione.

Installa sa360Api.py

Search Ads 360 fornisce uno script di utilità per semplificare il processo di configurazione delle autorizzazioni. Puoi anche utilizzare questo script per inviare e ricevere dati in formato JSON, se vuoi provare a inviare e ricevere dati prima di progettare e scrivere un'applicazione completa. Puoi copiare molti degli esempi JSON in questo sito di documentazione e inserirli direttamente nello script.

Per installare lo script:

  1. Installa Python 2.7.
    Lo script non funziona con Python 3.x.
  2. Installa cURL.
  3. Scarica sa360Api.zip.
  4. Estrai sa360Api.py da sa360Api.zip.
  5. Rendi sa360Api.py eseguibile.

Apprendere le nozioni di base di REST

Esistono due modi per richiamare l'API:

  • Utilizzare le librerie client.
  • Inviare richieste HTTP e analizzarne le risposte.

Se decidi di non utilizzare le librerie client, dovrai conoscere le nozioni di base di REST.

REST è un tipo di architettura software che fornisce un approccio pratico e coerente per la richiesta e la modifica dei dati.

Il termine REST è l'acronimo di "REpresentational State Transfer". Nel contesto delle API di Google, si riferisce all'utilizzo dei verbi HTTP per recuperare e modificare le rappresentazioni dei dati archiviati da Google.

In un sistema RESTful, le risorse vengono archiviate in un datastore. Un client invia una richiesta affinché il server esegua una determinata azione (ad esempio la creazione, il recupero, l'aggiornamento o l'eliminazione di una risorsa) e il server esegue l'azione e invia una risposta, spesso sotto forma di rappresentazione della risorsa specificata.

Nelle API RESTful di Google, il client specifica un'azione mediante un verbo HTTP come POST, GET, PUT o DELETE. La risorsa viene specificata tramite un URI globalmente univoco con il seguente formato:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

Poiché tutte le risorse dell'API dispongono di URI univoci accessibili tramite HTTP, REST consente la memorizzazione dei dati nella cache ed è ottimizzato per operare con l'infrastruttura distribuita del Web.

Potresti trovare utili le definizioni dei metodi nella documentazione degli standard HTTP 1.1, che include le specifiche per GET, POST, PUT e DELETE.

REST nell'API Search Ads 360

Le operazioni dell'API Search Ads 360 vengono mappate direttamente ai verbi HTTP REST.

Il formato specifico per gli URI dell'API Search Ads 360 è:

https://www.googleapis.com/doubleclicksearch/v2/resourcePath?parameters

L'insieme completo di URI utilizzati per ogni operazione supportata nell'API è descritto nel riferimento all'API.

Apprendere le nozioni di base di JSON

Se utilizzi REST, dovrai usare il formato JSON per il corpo delle richieste. Puoi specificare che le risposte siano in formato JSON o CSV.

JSON (JavaScript Object Notation) è un formato di dati comune, indipendente dal linguaggio, che fornisce una semplice rappresentazione testuale di strutture di dati arbitrarie. Per ulteriori informazioni, visita il sito json.org.