Method: exchanges.orders.patch

Atualiza um pedido.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
order.name

string

Nome do recurso relativo do pedido. Gerado pelo servidor. Exemplo: "exchanges/1234/orders/5678". Apenas saída.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação 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

Nome do pedido exibido ao comprador. Máximo de 250 caracteres. Opcional.
order.partnerId[]

string (int64 format)

ID do parceiro no Google Display &Video 360, anteriormente conhecido como DoubleClick Bid Manager(DBM). Permite apenas um ID de parceiro. Obrigatório.
order.publisherEmail

string

E-mail do editor. Precisa ser um formato de e-mail válido. Máximo de 250 caracteres. Opcional.
order.publisherName

string

Nome do editor. Máximo de 250 caracteres. Obrigatório.
order.budget

object (Budget)

Apenas saída. O orçamento definido pelo comprador. Aplicável apenas a cenários de negócios instantâneos.
order.status

enum (OrderStatus)

Status do pedido. O status pode mudar depois que os usuários do DV3 aceitam, cancelam ou arquivam um pedido. Também é possível atualizar para "CANCELADO" após a criação na API para indicar que esse pedido foi cancelado na Exchange.
order.wseatConfig

object (WSeatConfig)

Opcional. A configuração do WSeat especifica a configuração do WSeat no lado da Exchange. As Exchanges que usam negócios de vários assentos precisam manter esse campo preenchido e atualizado.
order.updateTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que o pedido ou os produtos subjacentes foram atualizados.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
order.buyerInfo

object (BuyerInfo)

Apenas saída. As informações do comprador, incluindo detalhes do parceiro e do anunciante. Aplicável apenas a cenários de negócios instantâneos.
updateMask

string (FieldMask format)

A máscara para controlar quais campos atualizar. Obrigatório.

É uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Order.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.