REST Resource: exchanges.orders

Risorsa: Order

Un'offerta non negoziabile che l'acquirente deve accettare.

Rappresentazione JSON 
{
  "name": string,
  "displayName": string,
  "partnerId": [
    string
  ],
  "publisherEmail": string,
  "publisherName": string,
  "budget": {
    object (Budget)
  },
  "status": enum (OrderStatus),
  "wseatConfig": {
    object (WSeatConfig)
  },
  "updateTime": string,
  "buyerInfo": {
    object (BuyerInfo)
  }
}
Campi
name

string

Nome della risorsa relativa per l'ordine. Generato dal server. Esempio: "exchanges/1234/orders/5678". Solo output.
displayName

string

Nome dell'ordine visualizzato dall'acquirente. Massimo 250 caratteri. Facoltativo.
partnerId[]

string (int64 format)

ID partner in Google Display & Video 360, precedentemente noto come DoubleClick Bid Manager(DBM). Consente un solo ID partner. Obbligatorio.
publisherEmail

string

Email per il publisher. Deve essere un formato email valido. Massimo 250 caratteri. Facoltativo.
publisherName

string

Nome dell'editore. Massimo 250 caratteri. Obbligatorio.
budget

object (Budget)

Solo output. Il budget impostato dall'acquirente. Applicabile solo agli scenari di offerta immediata.
status

enum (OrderStatus)

Stato dell'ordine. Lo stato può cambiare dopo che gli utenti di DV3 accettano, annullano o archiviano un ordine. Supporta anche l'aggiornamento a "ANNULLATO" dopo la creazione nell'API per segnalare che questo ordine è stato annullato su Exchange.
wseatConfig

object (WSeatConfig)

Facoltativo. WSeat Configuration Specifies the WSeat configuration on the exchange side. Gli scambi che utilizzano offerte multi-posto devono mantenere questo campo compilato e aggiornato.
updateTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo aggiornamento dell'ordine o dei relativi prodotti sottostanti.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
buyerInfo

object (BuyerInfo)

Solo output. Le informazioni sull'acquirente, inclusi i dettagli del partner e dell'inserzionista. Applicabile solo agli scenari di offerta immediata.

Budget

Budget specificato.

Rappresentazione JSON 
{
  "budgetType": enum (BudgetType),

  // Union field budget can be only one of the following:
  "impressions": string,
  "money": {
    object (Money)
  }
  // End of list of possible types for union field budget.
}
Campi
budgetType

enum (BudgetType)

Il tipo di budget specificato.
Campo unione budget. Può essere incluso un solo tipo di budget. budget può essere solo uno dei seguenti:
impressions

string (int64 format)

Budget impressioni.
money

object (Money)

Budget valuta.

BudgetType

Tipi di budget

Enum
BUDGET_TYPE_UNSPECIFIED Budget non specificato. Non valido per l'input.
BUDGET_TYPE_CURRENCY Budget valuta.
BUDGET_TYPE_IMPRESSION Budget impressioni.

OrderStatus

Stato dell'ordine.

Enum
ORDER_STATUS_UNSPECIFIED Stato dell'ordine non specificato. Inatteso, indica che lo stato della negoziazione è sconosciuto. Valore di input non valido.
PENDING_ACCEPTANCE Stato dell'ordine in attesa di accettazione.
ACCEPTED Stato dell'ordine accettato.
ARCHIVED Stato dell'ordine archiviato.
CANCELLED Stato dell'ordine annullato.
NEGOTIATING Stato dell'ordine in negoziazione. Applicabile solo agli scenari di deal istantaneo.

WSeatConfig

Configurazione WSeat.

Rappresentazione JSON 
{
  "exchangeWseatStatus": enum (WSeatStatus),
  "exchangeWseatIds": [
    string
  ],
  "updateTime": string
}
Campi
exchangeWseatStatus

enum (WSeatStatus)

Facoltativo. Lo stato attuale sul lato Exchange per la configurazione di WSeat.
exchangeWseatIds[]

string (int64 format)

Facoltativo. ID WSeat sul lato della piattaforma di scambio.
updateTime

string (Timestamp format)

Solo output. Questo campo viene aggiornato automaticamente da DV3 quando WSeatConfiguration viene aggiornato dallo scambio.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

WSeatStatus

Opzioni di enumerazione dello stato del sedile.

Enum
W_SEAT_STATUS_UNSPECIFIED WSeatStatus non specificato.
W_SEAT_STATUS_ENFORCED WSeatStatus applicato. Indica che Exchange applica WSeatId inviandolo a DV3 o verificando gli ID posto nelle risposte alle offerte.
W_SEAT_STATUS_NOT_ENFORCED WSeatStatus non applicato. Indica che l'exchange non invia wseatid nelle richieste di offerta e non lo convalida.

BuyerInfo

Informazioni sull'acquirente per gli scenari di deal istantaneo.

Rappresentazione JSON 
{
  "partner": {
    object (PartnerInfo)
  },
  "advertisers": [
    {
      object (AdvertiserInfo)
    }
  ]
}
Campi
partner

object (PartnerInfo)

Solo output. Informazioni sul partner.
advertisers[]

object (AdvertiserInfo)

Solo output. Informazioni sull'inserzionista.

PartnerInfo

Informazioni sul partner per gli scenari di deal istantaneo.

Rappresentazione JSON 
{
  "title": string
}
Campi
title

string

Solo output. Titolo visualizzato del partner in Display & Video 360.

AdvertiserInfo

Informazioni sull'inserzionista per gli scenari di deal istantaneo.

Rappresentazione JSON 
{
  "advertiserId": string,
  "domainUri": string
}
Campi
advertiserId

string (int64 format)

Solo output. ID inserzionista in Display & Video 360.
domainUri

string

Solo output. L'URI del dominio del sito web dell'inserzionista.

Metodi

accept

 Accetta l'ordine.

create

 Crea un ordine.

get

 Riceve l'ordine.

list

 Ordine degli elenchi.

patch

 Aggiorna un ordine.