La tua prima app: prerequisiti

Prima di poter iniziare a programmare la tua prima applicazione client, devi eseguire alcune operazioni, se non lo hai già fatto.

Crea un Account Google e ottieni le autorizzazioni di Search Ads 360

Per utilizzare l'API Search Ads 360, devi avere un Account Google e le autorizzazioni appropriate concesse a questo account in 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 collabori.

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

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

Attiva il servizio di conversione API

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

Creare un progetto della 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 guida nella creazione di un progetto (o nell'utilizzo di un progetto esistente), nell'attivazione dell'API Search Ads 360 e nella creazione di credenziali OAuth 2.0.
  2. Nella pagina Registra la tua applicazione, seleziona un progetto esistente oppure seleziona Crea un progetto. Poi fai clic su Continua.
  3. Dopo che la console API di Google abilita l'API Search Ads 360, fai clic sul pulsante Vai alle credenziali.
  4. Nella pagina Crea credenziali, inserisci le seguenti informazioni:
    • Quale API stai utilizzando?: API di Search Ads 360
    • A quali dati accederai?: Dati utente
  5. Fai clic sul pulsante Avanti.

    Lo strumento di configurazione offre ora la possibilità di creare un ID client OAuth 2.0.

  6. Segui i restanti passaggi nello strumento di configurazione.

Installa sa360Api.py

Search Ads 360 fornisce uno script di utilità per facilitare il processo di configurazione dell'autorizzazione. Puoi utilizzare questo script anche 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 della 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 eseguibile sa360Api.py.

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, devi comprendere 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 utilizzando un verbo HTTP come POST, GET, PUT o DELETE. Specifica una risorsa mediante un URI univoco a livello globale nel 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, in cui sono incluse 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

Il set completo di URI utilizzati per ogni operazione supportata nell'API è riepilogato nella sezione Riferimento API.

Apprendere le nozioni di base di JSON

Se utilizzi REST, dovrai utilizzare il formato JSON per i corpi delle richieste. Puoi specificare che le risposte devono essere in formato JSON o CSV.

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