Sfondo

Prima di iniziare

  1. Chiedi al rappresentante del tuo account di impostare le autorizzazioni appropriate per gli account a cui potrà accedere l'applicazione.
  2. Se non hai familiarità con i concetti di Authorized Buyers, visita la Centro assistenza Authorized Buyers e sperimentare con l'interfaccia utente. Se la tua applicazione dovrebbe eseguire offerte in tempo reale, leggi il documentazione sul protocollo RTB.
  3. Visita il Console API per configurare un nuovo progetto. Accedi al tuo Account Google sviluppatore oppure per creare un account. Ti verrà chiesto di creare un progetto e di uscire in un paio di Termini di servizio.

Account principali e secondari

Se lavori all'interno di una struttura di account che contiene account principale e secondario , potresti riuscire a lavorare in modo più efficace se comprendi in che modo interagire. Di seguito è riportato un breve riepilogo:

Account secondari

Un utente con credenziali che concedono l'accesso a un account bambino può visualizzare e modificare le risorse associate al proprio account. Gli account bambino non possono Visualizzare o modificare le risorse appartenenti ad altri account secondari o principali.

Account principali

Un utente con credenziali che concedono l'accesso a un account genitore può visualizzare e modificare le risorse per l'account principale, oltre a tutte le risorse account bambino/a. Per le operazioni che elencano tutte le risorse di una determinata risorsa, riceveranno una risposta che include i dati relativi al proprio account e a tutti account bambino/a. Tieni presente che, per altri tipi di richieste che hanno come target le risorse per le utenze secondarie, viene nell'account principale dovrà specificare un parametro di percorso accountId per il publisher secondario anziché il proprio accountId.

Il modello dei dati dell'API REST

Una risorsa è una singola entità di dati con un identificatore univoco. La La risorsa account rappresenta una voce di account Authorized Buyers ed è la risorsa principale per l'API Ad Exchange Buyers. I metodi dell'API operano su singole Risorse degli account e raccolte di risorse degli account.

Un account La risorsa include: un ID account, informazioni utilizzate nella corrispondenza dei cookie, le località degli offerenti, l'URL a cui vengono inviate le richieste di offerta e una richiesta per specificare il numero massimo di query al secondo che devono essere inviate dalla piattaforma di scambio pubblicitario.

Oltre alla risorsa e alla raccolta account, anche l'API Ad Exchange per acquirenti definisce le seguenti strutture di dati:

Località offerente

Le località degli offerenti sono strutture che vengono restituite con le risorse degli account. per fornire l'URL a cui la piattaforma di scambio pubblicitario deve inviare le richieste di offerta, il numero massimo di query al secondo che la piattaforma di scambio pubblicitario deve inviare. Ecco un esempio di località dell'offerente, espressa in JSON: 

"bidderLocation": [
    {
      "url": "http://bid.url.com/bidder",
      "maximumQps": 1500
    }
  ],

Elementi

Gli elementi forniscono un elenco di account. Ecco un esempio di elementi espressi in JSON: 

{
  "kind": "adexchangebuyer#accountsList",
  "items": [
    accounts Resource
  ]
}

Operazioni supportate

È possibile richiamare tre diversi metodi su raccolte e risorse dell'API Ad Exchange per gli acquirenti come descritto nella seguente tabella. Tutte le operazioni richiedono autorizzazione.

Operazione Descrizione Mappature REST HTTP
list Elenca tutti gli account a cui gli utenti attualmente autenticati possono accedere utente. GET su un URI della raccolta.
trova Recupera una risorsa Account specifica. GET su un URI della risorsa.
aggiorna Aggiorna una specifica risorsa Account. PUT su un URI della risorsa, dove passi i dati per l'URI risorsa aggiornata.

Stile di chiamata

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.

Potrebbero esserti utili le definizioni dei metodi riportate nella documentazione sugli standard HTTP 1.1. includono le specifiche per GET, POST, PUT e DELETE.

REST nell'API Ad Exchange Buyers

Le operazioni supportate mappano direttamente ai verbi HTTP REST, come descritto in Operazioni API.

Il formato specifico per gli URI delle API è:

https://www.googleapis.com/adexchangebuyer/v1.4/resourceID?parameters

dove resourceID è l'identificatore di un Risorsa account e parameters sono qualsiasi da applicare alla query. Consulta parametri di query standard e ai documentazione di riferimento per maggiori dettagli.

Il formato delle estensioni del percorso resourceID ti consente di identificare la risorsa su cui stai attualmente operando, ad esempio:

https://www.googleapis.com/adexchangebuyer/v1.4/accounts
https://www.googleapis.com/adexchangebuyer/v1.4/accounts/id

Il set completo di URI utilizzati per ogni operazione supportata nell'API è riassunte documentazione di riferimento.

Ecco un esempio di come funziona nell'API Ad Exchange per gli acquirenti.

Recupera l'elenco degli account dell'utente autenticato:

GET https://www.googleapis.com/adexchangebuyer/v1.4/accounts

Formato dei dati

JSON

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.