Method: exchanges.orders.patch

Actualiza un pedido.

Solicitud HTTP

PATCH https://dv360seller.googleapis.com/v1beta1/{order.name=exchanges/*/orders/*}

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
order.name

string

Nombre del recurso relativo del pedido. Generado por el servidor. Ejemplo: "exchanges/1234/orders/5678". Solo salida.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "order": {
    "name": string,
    "displayName": string,
    "partnerId": [
      string
    ],
    "publisherEmail": string,
    "publisherName": string,
    "budget": {
      "budgetType": enum (BudgetType),

      // The following is a list of mutually exclusive fields. At most one of the
      // fields will be set in a response:
      "impressions": string,
      "money": {
        object (Money)
      }
      // End of mutually exclusive fields.
    },
    "status": enum (OrderStatus),
    "wseatConfig": {
      "exchangeWseatStatus": enum (WSeatStatus),
      "exchangeWseatIds": [
        string
      ],
      "updateTime": string
    },
    "updateTime": string,
    "buyerInfo": {
      "partner": {
        object (PartnerInfo)
      },
      "advertisers": [
        {
          object (AdvertiserInfo)
        }
      ]
    }
  },
  "updateMask": string
}
Campos
order.displayName

string

Nombre del pedido que se muestra al comprador. Máximo de 250 caracteres. Es opcional.
order.partnerId[]

string (int64 format)

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

string

Es el correo electrónico del publicador. Debe ser un formato de correo electrónico válido. Máximo de 250 caracteres. Es opcional.
order.publisherName

string

Es el nombre del publicador. Máximo de 250 caracteres. Obligatorio.
order.budget

object (Budget)

Solo salida. Es el presupuesto establecido por el comprador. Solo se aplica a situaciones de ofertas instantáneas.
order.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 admite la actualización a "CANCELLED" después de la creación en la API para indicar que este pedido se canceló en el Exchange.
order.wseatConfig

object (WSeatConfig)

Es opcional. La configuración de WSeat especifica la configuración de WSeat en el lado del Exchange. Se espera que los Exchanges que utilizan ofertas de varios asientos mantengan este campo actualizado.
order.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 usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. 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".
order.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 ofertas instantáneas.
updateMask

string (FieldMask format)

Es la máscara para controlar qué campos se actualizarán. Obligatorio.

Esta es una lista separada por comas de los nombres de campos completamente calificados. Ejemplo: "user.displayName,photo".

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Order.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/doubleclickbidmanager

Para obtener más información, consulta OAuth 2.0 Overview.