REST Resource: sellers.orders.lines

Recurso: linha

Uma única linha de pedido que representa um produto configurado.

Representação JSON 
{
  "name": string,
  "product": string,
  "externalId": string,
  "displayName": string,
  "description": string,
  "state": enum (State),
  "rejection": {
    object (Rejection)
  },
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "transactionType": enum (TransactionType),
  "pricingType": enum (PricingType),
  "externalDealId": string,
  "creativeType": enum (CreativeType),
  "budget": {
    object (Money)
  },
  "lineTerms": {
    object (LineTerms)
  },
  "pendingReservationExpirationTime": string,
  "reservationExpirationTime": string,
  "targeting": {
    object (Targeting)
  },
  "createTime": string,
  "updateTime": string
}
Campos
name

string

O nome de recurso da linha no formato: sellers/{seller}/orders/{order}/lines/{line}.
product

string

O nome do Product que essa linha está configurando. Formato: sellers/{seller}/products/{product}
externalId

string

Um ID usado para mapear esta entidade para origens externas.
displayName

string

O nome de exibição da linha.
description

string

Campo de formato livre adicional para descrever a linha.
state

enum (State)

Apenas saída. O estado da linha. Consulte State para ver o ciclo de vida de uma linha.

O vendedor pode usar os seguintes métodos personalizados: Reserve, Book e Reject para definir como um dos seguintes:

  • STATE_RESERVED
  • STATE_BOOKED
  • STATE_REJECTED_BY_SELLER.

Todos os outros estados da linha são definidos pelo comprador.
rejection

object (Rejection)

Detalhes da rejeição da linha.
startDate

object (Date)

A data em que a linha começaria a ser veiculada (inclusive). Mesmo fuso horário que o bloco de anúncios.
endDate

object (Date)

A data em que a linha deixaria de ser veiculada (inclusive). Mesmo fuso horário que o bloco de anúncios.
transactionType

enum (TransactionType)

Tipo de transação para esta linha.
pricingType

enum (PricingType)

Tipo de precificação para esta linha.
externalDealId

string

ID externo da transação para esta linha. Se fornecido, a linha será definida para execução de RTB se configurada para o vendedor. Caso contrário, haverá erros.
creativeType

enum (CreativeType)

Tipo de criativo para esta linha. O produto especificado para esta linha deve ser compatível com o tipo de criativo fornecido.
budget

object (Money)

Apenas saída. O orçamento da linha.
lineTerms

object (LineTerms)

Apenas saída. Os termos garantidos do vendedor para esta linha.
pendingReservationExpirationTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora de expiração da reserva pendente. O vendedor precisa fazer a reserva ou recusar antes que uma reserva pendente expire. Caso contrário, ela será tratada como recusada.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
reservationExpirationTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora de expiração da reserva. O comprador precisa fazer a reserva antes que ela expire. Caso contrário, ela será tratada como cancelada.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
targeting

object (Targeting)

A segmentação da linha.
createTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora de criação da linha.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora da última atualização da linha.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

Estado

Estado de uma linha.

Enums
STATE_UNSPECIFIED O valor padrão quando o estado da linha não foi especificado ou é desconhecido nesta versão.
STATE_PENDING_RESERVATION A linha foi criada pelo comprador e solicita que os produtos sejam reservados, além de atualizados com informações de preço e disponibilidade.
STATE_RESERVED A linha foi reservada pelo vendedor. Esse estado só é possível quando o estado anterior é uma reserva pendente.
STATE_PENDING_BOOKING O comprador aceitou a reserva e está solicitando a linha para ser reservada.
STATE_BOOKED O vendedor reservou a linha. Esse estado só é possível quando o estado anterior está com reserva pendente. Não são esperadas rejeições nesta fase.
STATE_REJECTED_BY_SELLER A linha foi rejeitada pelo vendedor. Esse estado só é possível quando o estado anterior é uma reserva pendente.
STATE_CANCELLED_BY_BUYER A linha foi cancelada pelo comprador.
STATE_PENDING_RESERVATION_EXPIRED A linha expirou enquanto a reserva estava pendente.
STATE_RESERVED_EXPIRED A linha expirou enquanto reservada, aguardando a resposta do comprador.

TransactionType

Tipo de transação de uma linha.

Enums
TRANSACTION_TYPE_UNSPECIFIED É o valor padrão quando a troca não foi especificada ou é desconhecido nessa versão.
TRANSACTION_TYPE_RESERVED A transação é reservada (garantida).
TRANSACTION_TYPE_NON_RESERVED A transação não é reservada (não garantida).

PricingType

Tipo de preço para uma linha.

Enums
PRICING_TYPE_UNSPECIFIED É o valor padrão quando a troca não foi especificada ou é desconhecido nessa versão.
PRICING_TYPE_FIXED Preço fixo por impressão.
PRICING_TYPE_AUCTION O preço da impressão será determinado pelo leilão.

Métodos

book

 Contrata uma linha existente.

create

 Cria uma linha.

get

 Recupera uma linha individual de um pedido.

list

 Lista as linhas de um pedido.

patch

 Atualiza uma linha existente.

reject

 Rejeita uma linha existente.

reserve

 Reserva uma linha existente.