Guida illustrativa

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

Creazione di utenti

UserService consente a un utente con diritti di amministratore di creare un utente direttamente nella propria rete. Qualsiasi sviluppatore può farlo senza dover prima registrare il nuovo utente. 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), potresti creare alcuni utenti con ruoli come Commerciale, Trafficker o Inserzionista per testare i flussi di lavoro reali.

1. Crea alcuni nuovi indirizzi Gmail, ad esempio [e-mail]. In alternativa, registra un indirizzo non Gmail esistente come nuovo Account Google.
2. Chiama createUsers con il nuovo indirizzo e il numero Role scelto.
3. Puoi autenticarti come nuovo utente utilizzando OAuth 2.0 per generare il token di accesso.

Ottenere l'unità pubblicitaria principale

Sia i AdUnit di livello più alto a cui puoi aggiungere nodi secondari sia la profondità consentita della gerarchia dipendono dal tuo tipo di account (Small Business o Premium). Il valore AdUnit di livello 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:diversi tipi di account supportano pattern gerarchici diversi.

Esecuzione di query per un oggetto

Puoi cercare gli oggetti in base ai criteri di ricerca utilizzando il metodo getObjectsByStatement() esposto da molti servizi, dove Object è un tipo di oggetto specifico. Questo metodo accetta una query PQL, che è simile a una query SQL, in quanto consente di specificare i campi da cercare (in cui i nomi dei campi sono mappati alle proprietà dell'oggetto), ordinare, limitare e correggere i risultati di ricerca. Consulta la guida PQL per scoprire di più su PQL e anche per sapere in quali campi degli oggetti puoi filtrare.

Creazione di un ordine

Per creare un ordine, è sufficiente creare un oggetto Order e impostare gli ID inserzionista, commerciale e trafficker sugli utenti appropriati, assegnare un nome univoco e chiamare createOrders(). Il risultato includerà l'oggetto 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, procedi nel seguente modo:

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 da escludere.
4. Racchiudi l'oggetto InventoryTargeting all'interno di un nuovo oggetto Targeting e assegnalo alla proprietà di targeting di LineItem.
5. Chiama il metodo di servizio degli elementi pubblicitari createLineItems() con il nuovo oggetto ed esamina il risultato per verificare se l'oggetto è stato creato.

Esempio

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

Realizzare una creatività

Diversi tipi di creatività supportano componenti diversi: ad esempio, una creatività immagine supporta un solo file di origine per l'immagine; una creatività Flash supporta due file di asset sottostanti: un file Flash e un file immagine di backup, nel caso in cui non sia possibile pubblicare il file Flash. Per le creatività ospitate su siti di terze parti, caricherai solo uno snippet HTML che fa riferimento al file sul server di terze parti. Consulta la sottoclasse Creative specifica per sapere quali asset dovrai caricare per creare la tua creatività.

Esempio

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

Modifica di un oggetto esistente

Per modificare un oggetto esistente, esegui una query sull'oggetto chiamando getObjectsByStatement(), aggiorna i valori negli oggetti restituiti e chiama updateObjects().

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

Modificare lo stato dell'oggetto

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

• Un'istanza dell'oggetto azione che descrive ciò che vuoi fare. Ad esempio, il servizio per gli ordini espone diverse azioni, tra cui ApproveOrders, PauseOrders e ArchiveOrders. Gli oggetti Azione derivano tutti da una classe di azioni 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'istruzione PQL appropriata.

Generare tag annuncio

Non puoi generare tag annuncio utilizzando l'API; devi invece utilizzare il sito web di Google Ad Manager. Per ulteriori informazioni, consulta la sezione del Centro assistenza Tagging .

Altri esempi

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