REST Resource: sellers.adUnits

Risorsa: unità pubblicitaria

Una singola unità pubblicitaria.

Rappresentazione JSON 
{
  "name": string,
  "externalId": string,
  "displayName": string,
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "attributes": [
    enum (AdUnitAttribute)
  ],
  "creatives": [
    {
      object (CreativeSpecification)
    }
  ],
  "createTime": string,
  "updateTime": string,
  "state": enum (AdUnitState),
  "rejectedReason": string,
  "location": {
    object (LatLng)
  },
  "directionSet": boolean,
  "direction": integer,
  "elevationMetersSet": boolean,
  "elevationMeters": number,
  "physicalWidthMetersSet": boolean,
  "physicalWidthMeters": number,
  "physicalHeightMetersSet": boolean,
  "physicalHeightMeters": number,
  "venue": enum (OutOfHomeVenue),
  "fixedLocation": boolean,
  "indoors": boolean,
  "photoUris": [
    string
  ],
  "products": [
    string
  ]
}
Campi
name

string

Il nome della risorsa dell'unità pubblicitaria nel formato: sellers/{seller}/adUnits/{adUnit}. Ad esempio sellers/seller321/adUnits/adUnit123.
externalId

string

ID gestito dal venditore, presumibilmente nel relativo sistema. Una volta impostato, è improbabile che cambi.
displayName

string

Obbligatorio. Il nome visualizzato dell'unità pubblicitaria.

Deve essere codificata in UTF-8 con una dimensione massima di 240 byte.
description

string

Campo in formato libero aggiuntivo per descrivere l'unità pubblicitaria.
labels

map (key: string, value: string)

L'insieme di etichette in formato libero per descrivere questa unità pubblicitaria.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
attributes[]

enum (AdUnitAttribute)

Attributi per definire ulteriormente l'unità pubblicitaria.
creatives[]

object (CreativeSpecification)

Elenco delle creatività consentite che possono essere pubblicate per questa unità pubblicitaria. Può essere definito anche a livello di prodotto.
createTime

string (Timestamp format)

Solo output. Timestamp della creazione dell'unità pubblicitaria.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo aggiornamento dell'unità pubblicitaria.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
state

enum (AdUnitState)

Solo output. Lo stato dell'unità pubblicitaria. Se AD_UNIT_STATE_REJECTED, il motivo del rifiuto conterrà il motivo.
rejectedReason

string

Solo output. Se lo stato di approvazione è AD_UNIT_APPROVAL_STATUS_REJECTED, questo campo conterrà il motivo.
location

object (LatLng)

Obbligatorio. Immutabile. La latitudine e la longitudine dell'unità pubblicitaria nel formato in gradi con segno.
directionSet

boolean

Se impostato su true, il campo della direzione conterrà il valore della direzione. Se il valore è false, la direzione deve essere zero.
direction

integer

Immutabile. La direzione dei cardinali in gradi con il nord che rappresenta 0. [0-360].
elevationMetersSet

boolean

Se impostato su true, il campo elevazione conterrà l'elevazione in metri. Se il valore è false, l'elevazione deve essere pari a zero.
elevationMeters

number

Immutabile. La distanza dal bordo inferiore dell'unità pubblicitaria al suolo in metri.
physicalWidthMetersSet

boolean

Se true, il campo riguardanti la larghezza fisica è in metri. Se è false, l'utilizzo di fisiciLarghezzaMeters deve essere pari a zero.
physicalWidthMeters

number

Immutabile. La larghezza fisica dell'unità pubblicitaria in metri.
physicalHeightMetersSet

boolean

Se true, il campo averageHeightMeters conterrà l'altezza fisica in metri. Se il valore è false, l'HeightMeters fisici deve essere zero.
physicalHeightMeters

number

Immutabile. L'altezza fisica dell'unità pubblicitaria in metri.
venue

enum (OutOfHomeVenue)

Il tipo di locale fuori casa in base agli standard del DPAA. Si tratta di un campo informativo che può essere presentato agli inserzionisti e può anche essere utilizzato per filtrare le unità pubblicitarie.
fixedLocation

boolean

Se l'annuncio si trova in una posizione fissa (billboard) o in movimento (taxi).
indoors

boolean

Obbligatorio. Indica se l'unità pubblicitaria è interna.
photoUris[]

string

URI della foto dell'unità pubblicitaria.
products[]

string

Obbligatorio. I nomi delle risorse dei prodotti associati a questa unità pubblicitaria nel formato: sellers/{seller}/products/{product}. Ad esempio sellers/seller111/products/product123.

AdUnitAttribute

Possibili attributi utilizzati per definire ulteriormente l'unità pubblicitaria.

Enum
AD_UNIT_ATTRIBUTE_UNSPECIFIED Valore predefinito quando l'attributo dell'unità pubblicitaria non è specificato o non è noto in questa versione.
AD_UNIT_ATTRIBUTE_ILLUMINATED L'unità pubblicitaria è visibile al buio se si trova nel mondo fisico.
AD_UNIT_ATTRIBUTE_DIGITAL È implicita un'unità pubblicitaria digitale, se non è incluso il fisico classico.
AD_UNIT_ATTRIBUTE_PHYSICAL L'unità pubblicitaria esiste come oggetto nel mondo fisico.

AdUnitState

Stato di un'unità pubblicitaria dal punto di vista del venditore.

Enum
AD_UNIT_STATE_UNSPECIFIED Valore predefinito quando lo stato dell'unità pubblicitaria non è specificato o è sconosciuto in questa versione.
AD_UNIT_STATE_PENDING L'unità pubblicitaria è in attesa di approvazione.
AD_UNIT_STATE_APPROVED L'unità pubblicitaria è approvata.
AD_UNIT_STATE_REJECTED L'unità pubblicitaria è stata rifiutata.
AD_UNIT_STATE_DELETED Unità pubblicitaria eliminata.

OutOfHomeVenue

Elenco dei tipi di sedi esterne in base agli standard del DPAA.

Enum
OOH_VENUE_UNSPECIFIED Valore predefinito quando la sede OOH non è specificata o è sconosciuta in questa versione.
OOH_VENUE_AIRBORNE Luogo fuori casa classificato come in volo.
OOH_VENUE_AIRPORTS_GENERAL Sede esterna classificata come aeroporti generali.
OOH_VENUE_AIRPORTS_BAGGAGE_CLAIM Sede esterna classificata come ritiro bagagli in aeroporto.
OOH_VENUE_AIRPORTS_TERMINAL Sede esterna classificata come terminal degli aeroporti.
OOH_VENUE_AIRPORTS_LOUNGES Struttura esterna classificata come lounge degli aeroporti.
OOH_VENUE_ATMS Locale esterno classificato come bancomat.
OOH_VENUE_BACKLIGHTS Locale esterno classificato come retroilluminazione.
OOH_VENUE_BARS Locale fuori casa classificato come bar.
OOH_VENUE_BENCHES Locale fuori casa classificato come panchine.
OOH_VENUE_BIKE_RACKS Luogo fuori casa classificato come portabici.
OOH_VENUE_BULLETINS Sede fuori casa classificata come bollettini.
OOH_VENUE_BUSES Luogo fuori casa classificato come autobus.
OOH_VENUE_CAFES Locale fuori casa classificato come bar.
OOH_VENUE_CASUAL_DINING_RESTAURANTS Locale fuori casa classificato come ristoranti informali.
OOH_VENUE_CHILD_CARE Sede fuori casa classificata come asilo nido.
OOH_VENUE_CINEMA Locale fuori casa classificato come cinema.
OOH_VENUE_CITY_INFORMATION_PANELS Luogo fuori casa classificato come riquadri informativi sulla città.
OOH_VENUE_CONVENIENCE_STORES Locale esterno classificato come minimarket.
OOH_VENUE_DEDICATED_WILD_POSTING Luogo esterno classificato come pubblicazione selvaggia dedicata.
OOH_VENUE_DOCTORS_OFFICES_GENERAL Sede esterna classificata come studi medici generali.
OOH_VENUE_DOCTORS_OFFICES_OBSTETRICS Luogo fuori casa classificato come ostetricia degli studi medici.
OOH_VENUE_DOCTORS_OFFICES_PEDIATRICS Struttura esterna classificata come studi medici pediatrici.
OOH_VENUE_FAMILY_ENTERTAINMENT Locale fuori casa classificato come intrattenimento per famiglie.
OOH_VENUE_FERRIES Luogo fuori casa classificato come traghetti.
OOH_VENUE_FINANCIAL_SERVICES Locale esterno classificato come servizi finanziari.
OOH_VENUE_GAS_STATIONS Locale esterno classificato come stazioni di servizio.
OOH_VENUE_GOLF_COURSES Luogo fuori casa classificato come campi da golf.
OOH_VENUE_GYMS Struttura esterna classificata come palestre.
OOH_VENUE_HOSPITALS Struttura esterna classificata come ospedali.
OOH_VENUE_HOTELS Struttura esterna classificata come hotel.
OOH_VENUE_JUNIOR_POSTERS Locale esterno classificato come locandina per ragazzi.
OOH_VENUE_KIOSKS Locale esterno classificato come chioschi.
OOH_VENUE_MALLS_GENERAL Centro fuori casa classificato come centri commerciali generali.
OOH_VENUE_MALLS_FOOD_COURTS Locale fuori casa classificato come aree ristorazione dei centri commerciali.
OOH_VENUE_MARINE Luogo fuori casa classificato come marino.
OOH_VENUE_MOBILE_BILLBOARDS Locale esterno classificato come cartelloni pubblicitari mobile.
OOH_VENUE_MOVIE_THEATER_LOBBIES Locale esterno classificato come sala cinema.
OOH_VENUE_NEWSSTANDS Locale esterno classificato come edicola.
OOH_VENUE_OFFICE_BUILDINGS Sede fuori casa classificata come edifici per uffici.
OOH_VENUE_PHONE_KIOSKS Locale esterno classificato come chioschi telefonici.
OOH_VENUE_POSTERS Locale esterno classificato come poster.
OOH_VENUE_QSR Sede esterna classificata come qsr.
OOH_VENUE_RAIL Luogo esterno classificato come ferroviario.
OOH_VENUE_RECEPTACLES Locale esterno classificato come prese.
OOH_VENUE_RESORTS Struttura esterna classificata come resort.
OOH_VENUE_RETAIL Locale esterno classificato come vendita al dettaglio.
OOH_VENUE_SALONS Centro fuori casa classificato come parrucchiere.
OOH_VENUE_SHELTERS Luogo esterno classificato come rifugi.
OOH_VENUE_SPORTS_ARENAS Sede esterna classificata come arene sportive.
OOH_VENUE_SUBWAY Locale fuori casa classificato come metropolitana.
OOH_VENUE_TAXIS Locale esterno classificato come taxi.
OOH_VENUE_TRUCKSIDE Locale fuori casa classificato come lato camion.
OOH_VENUE_UNIVERSITIES Sede esterna classificata come università.
OOH_VENUE_URBAN_PANELS Locale esterno classificato come pannelli urbani.
OOH_VENUE_VETERINARIAN_OFFICES Luogo fuori casa classificato come ambulatori veterinari.
OOH_VENUE_WALLS Locale fuori casa classificato come pareti.
OOH_VENUE_OTHER Locale fuori casa classificato come altro.

Metodi

create

 Crea una nuova unità pubblicitaria.

delete

 Elimina un'unità pubblicitaria esistente.

get

 Recupera una singola unità pubblicitaria.

list

 Elenca le unità pubblicitarie.

patch

 Consente di aggiornare un'unità pubblicitaria esistente.