Guida illustrativa

Questa pagina fornisce dettagli su come eseguire attività comuni utilizzando l'API.

Creazione di utenti

UserService consente un utente con diritti di amministratore per creare un utente direttamente nella sua rete. Qualsiasi sviluppatore può farlo senza prima di chiedere al nuovo utente di registrarsi. Ad esempio, se stai provando l'API per la prima volta, invece di eseguire ogni chiamata API come amministratore (l'impostazione predefinita per il tuo indirizzo email), ti consigliamo di creare alcuni utenti con ruoli come Commerciale, Trafficker o Inserzionista per testare flussi di lavoro reali.

  1. Crea nuovi indirizzi Gmail, ad esempio my.name.salesperson@gmail.com. In alternativa, Registrare un indirizzo non Gmail esistente come nuovo Account Google.
  2. Chiama createUsers con il nuovo indirizzo e il numero Role scelto.
  3. Puoi autenticarti con il nuovo utente utilizzando OAuth 2.0 per generare il token di accesso.

Recupero dell'unità pubblicitaria principale

Sia il AdUnit di livello più alto a cui puoi aggiungere nodi figlio sia la profondità consentita della gerarchia dipendono dal tipo di account (Small Business o Premium). Il AdUnit più alto che supporta la modifica dei relativi nodi figlio è chiamato AdUnit radice effettiva.

Per recuperare la radice effettiva, chiama NetworkService.getCurrentNetwork() ed esamina il campo effectiveRootAdUnitId nell'oggetto Network restituito.

Nota:tipi di account diversi supportano pattern gerarchici diversi.

Esecuzione di query su un oggetto

Puoi cercare oggetti in base a criteri di ricerca usando il metodo getObjectsByStatement() esposto da molti servizi, dove Object è un tipo di oggetto specifico. Questo prende una query PQL, simile a una query SQL in quanto consente di specificare i campi in cui eseguire la ricerca (dove i nomi dei campi corrispondono alle proprietà dell'oggetto), limite e compensare i risultati di ricerca. Consulta il PQL per saperne di più su PQL e per sapere quali campi oggetto puoi filtra per.

Creazione di un ordine

Per creare un ordine, crea semplicemente un oggetto Order e imposta l'inserzionista, gli ID commerciale e quelli dei trafficker agli utenti appropriati, assegnano un nome univoco, e chiama createOrders(). Il risultato includerà l'elemento Order appena creato, o un errore.

Esempio

Vedi un esempio di codice Java per la creazione di un ordine.

Creare un elemento pubblicitario

Per creare un nuovo elemento pubblicitario:

  1. Crea un nuovo oggetto Order o utilizzane uno esistente.
  2. Crea un nuovo oggetto LineItem e imposta il tipo di rotazione, l'array delle dimensioni della creatività le date di inizio e di fine e altre proprietà.
  3. Crea un nuovo oggetto InventoryTargeting e specifica gli oggetti Placement o AdUnit da scegliere come target o escludere.
  4. Aggrega l'oggetto InventoryTargeting all'interno di un nuovo oggetto Targeting e assegna alla proprietà di targeting di LineItem.
  5. Chiama il metodo di servizio dell'elemento pubblicitario createLineItems() con il nuovo oggetto ed esamina il risultato per vedere se l'oggetto è stato creato.

Esempio

Vedi un esempio di codice Java per la creazione di un elemento pubblicitario.

Realizzare una creatività

Tipi di creatività diversi supportano componenti differenti: ad esempio, un'immagine la creatività supporta un unico file di origine per l'immagine; una creatività Flash supporta due file di asset alla base: un file Flash e un file immagine di backup, nel caso in cui . Per le creatività ospitate su siti di terze parti, devi caricare solo uno snippet HTML che fa riferimento al file sul server di terze parti. Visualizza sottoclasse Creative specifica per sapere quali asset caricare in ordine per realizzare la tua creatività.

Esempio

Consulta l'esempio di codice Java per la creazione di una creatività immagine.

Modificare un oggetto esistente

Per modificare un oggetto esistente, esegui una query per l'oggetto chiamando getObjectsByStatement(), aggiornare i valori negli oggetti restituiti, quindi richiamare updateObjects().

Nota: gli oggetti aggiornati sostituiranno completamente quelli esistenti, quindi se non impostare un valore di proprietà nell'oggetto inviato, l'oggetto salvato ottiene il valore predefinito per quella proprietà, non il valore precedente.

Modificare lo stato degli oggetti

Lo stato dell'oggetto viene modificato chiamando il metodo performObjectAction() esposto dal tuo servizio. Questo metodo richiede due parametri:

  • Un'istanza dell'oggetto action che descrive l'operazione da eseguire. Per istanza, il servizio ordini espone diverse azioni tra cui ApproveOrders, PauseOrders, e ArchiveOrders. Gli oggetti azione derivano tutti da un'azione di base appropriata per il tuo servizio.
  • Una query PQL che descrive quali oggetti modificare. Puoi modificare lo stato di uno o più oggetti alla volta specificando un PQL appropriato l'Informativa.

Generazione di tag annuncio

Non è possibile generare tag annuncio utilizzando l'API; devi utilizzare il sito web di Google Ad Manager. Consulta la sezione Tagging del Centro assistenza per ulteriori informazioni.

Altri esempi

Puoi trovare molti altri esempi nel codice campione della libreria client, in diversi linguaggi di programmazione diversi. Consulta Librerie client e Codice di esempio per un link agli esempi nel tuo linguaggio di programmazione.