REST Resource: exchanges.orders

Recurso: Pedido

Es una oferta no negociable que el comprador debe aceptar.

Representación 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)
  }
}
Campos
name

string

Es el nombre del recurso relativo del pedido. El servidor lo genera. Ejemplo: “exchanges/1234/orders/5678”. Solo salida.
displayName

string

Es el nombre del pedido que se muestra al comprador. Máx. 250 caracteres. Opcional.
partnerId[]

string (int64 format)

Es el ID de socio en Google Display & Video 360, antes conocido como DoubleClick Bid Manager(DBM). Solo permite un ID de socio. Es obligatorio.
publisherEmail

string

Correo electrónico del publicador. Debe ser un formato de correo electrónico válido. Máx. 250 caracteres. Opcional.
publisherName

string

Nombre del editor. Máx. 250 caracteres. Es obligatorio.
budget

object (Budget)

Solo salida. Es el presupuesto establecido por el comprador. Solo se aplica a situaciones de acuerdos instantáneos.
status

enum (OrderStatus)

Es el estado del pedido. El estado puede cambiar después de que los usuarios de DV3 acepten, cancelen o archiven un pedido. También se admite la actualización a "CANCELLED" después de la creación en la API para indicar que se canceló este pedido en el Exchange.
wseatConfig

object (WSeatConfig)

Opcional. WSeat Configuration Especifica la configuración de WSeat en el lado del intercambio. Se espera que los intercambios que utilizan acuerdos de múltiples posiciones mantengan este campo actualizado y completo.
updateTime

string (Timestamp format)

Solo salida. Es la marca de tiempo en la que se actualizó el pedido o sus productos subyacentes.

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
buyerInfo

object (BuyerInfo)

Solo salida. Es la información del comprador, incluidos los detalles del socio y el anunciante. Solo se aplica a situaciones de acuerdos instantáneos.

Presupuesto

Se especificó el presupuesto.

Representación 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.
}
Campos
budgetType

enum (BudgetType)

Es el tipo de presupuesto especificado.
Campo de unión budget. Solo se puede incluir un tipo de presupuesto. Las direcciones (budget) solo pueden ser una de las siguientes opciones:
impressions

string (int64 format)

Es el presupuesto de impresiones.
money

object (Money)

Es el presupuesto en la moneda.

BudgetType

Tipos de presupuesto

Enumeraciones
BUDGET_TYPE_UNSPECIFIED Presupuesto sin especificar. No es válido como entrada.
BUDGET_TYPE_CURRENCY Es el presupuesto en la moneda.
BUDGET_TYPE_IMPRESSION Es el presupuesto de impresiones.

OrderStatus

Es el estado del pedido.

Enumeraciones
ORDER_STATUS_UNSPECIFIED No se especificó el estado del pedido. Indica que el estado de la negociación es desconocido, lo que no debería ocurrir. El valor de entrada no es válido.
PENDING_ACCEPTANCE El estado del pedido es pendiente de aceptación.
ACCEPTED Se aceptó el estado del pedido.
ARCHIVED Se archivó el estado del pedido.
CANCELLED Se canceló el estado del pedido.
NEGOTIATING Se está negociando el estado del pedido. Solo se aplica a situaciones de ofertas instantáneas.

WSeatConfig

Es la configuración de WSeat.

Representación JSON 
{
  "exchangeWseatStatus": enum (WSeatStatus),
  "exchangeWseatIds": [
    string
  ],
  "updateTime": string
}
Campos
exchangeWseatStatus

enum (WSeatStatus)

Opcional. Es el estado actual en el servidor de Exchange para la configuración de WSeat.
exchangeWseatIds[]

string (int64 format)

Opcional. Son los IDs de WSeat en el lado del intercambio.
updateTime

string (Timestamp format)

Solo salida. DV3 actualiza este campo automáticamente cuando el intercambio actualiza WSeatConfiguration.

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

WSeatStatus

Opciones de enumeración de estado de WSeat.

Enumeraciones
W_SEAT_STATUS_UNSPECIFIED WSeatStatus no está especificado.
W_SEAT_STATUS_ENFORCED Se aplica WSeatStatus. Indica que Exchange aplica WSeatId enviándolo a DV3 o verificando los wseatids en las respuestas de ofertas.
W_SEAT_STATUS_NOT_ENFORCED WSeatStatus no se aplica. Indica que Exchange no envía wseatid en las solicitudes de ofertas ni valida wseatid en las solicitudes de ofertas.

BuyerInfo

Es la información del comprador para situaciones de acuerdos instantáneos.

Representación JSON 
{
  "partner": {
    object (PartnerInfo)
  },
  "advertisers": [
    {
      object (AdvertiserInfo)
    }
  ]
}
Campos
partner

object (PartnerInfo)

Solo salida. Es la información del socio.
advertisers[]

object (AdvertiserInfo)

Solo salida. Información del anunciante

PartnerInfo

Es la información del socio para situaciones de acuerdos instantáneos.

Representación JSON 
{
  "title": string
}
Campos
title

string

Solo salida. Es el título visible del socio en Display & Video 360.

AdvertiserInfo

Es la información del anunciante para situaciones de acuerdos instantáneos.

Representación JSON 
{
  "advertiserId": string,
  "domainUri": string
}
Campos
advertiserId

string (int64 format)

Solo salida. Es el ID del anunciante en Display & Video 360.
domainUri

string

Solo salida. Es el URI del dominio del sitio web del anunciante.

Métodos

accept

 Acepta el pedido.

create

 Crea un pedido.

get

 Obtiene el pedido.

list

 Es el orden de la lista.

patch

 Actualiza un pedido.