REST Resource: availabilityOrders

Recurso: DisponibilidadeOrder

Um pedido de disponibilidade é uma coleção de AvailabilityLines. O pedido de disponibilidade é criado pelo comprador. O vendedor atualiza a disponibilidade com a resposta.

O fluxo de trabalho é o seguinte:

  • O comprador cria pedidos e linhas de disponibilidade e define o estado como pendente. Não são permitidas outras alterações do comprador no pedido ou linha de disponibilidade.
  • O vendedor age em todas as linhas de disponibilidade preenchendo os termos de disponibilidade ou marcando como rejeitados. As ações "Concluir" ou "Rejeitar" só são possíveis quando o pedido e as linhas estão no estado pendente.
  • O vendedor usa a ação personalizada complete para marcar a solicitação de disponibilidade como concluída. Não são permitidas outras alterações no pedido de disponibilidade ou nas linhas secundárias após a conclusão.
Representação JSON 
{
  "name": string,
  "description": string,
  "state": enum (State),
  "pendingExpirationTime": string,
  "createTime": string,
  "updateTime": string,
  "advertiserInfo": {
    object (AdvertiserInfo)
  }
}
Campos
name

string

Apenas saída. O nome do recurso do pedido de disponibilidade no formato: availabilityOrders/{id}.
description

string

Apenas saída. Campo de formato livre adicional para descrever o pedido de disponibilidade.
state

enum (State)

Apenas saída. O estado deste pedido de disponibilidade. Consulte AvailabilityOrder.State para ver o ciclo de vida de um InventoryOrder.

O vendedor pode usar o método personalizado Complete para definir como STATE_COMPLETED.
pendingExpirationTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora de expiração do pedido de disponibilidade pendente. O vendedor precisa concluir o pedido antes que um pedido de disponibilidade pendente expire. Caso contrário, ele será tratado como concluído e sem disponibilidade.

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".
createTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora da criação Atribuído pelo sistema.

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. Atribuído pelo sistema.

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".
advertiserInfo

object (AdvertiserInfo)

Apenas saída. Informações do anunciante.

Estado

Valores possíveis para o estado do pedido de disponibilidade.

Enums
STATE_UNSPECIFIED É o valor padrão quando o estado do pedido de disponibilidade não foi especificado ou é desconhecido nesta versão.
STATE_PENDING Disponibilidade pendente quando o comprador forneceu as configurações de solicitação de disponibilidade.
STATE_COMPLETED Estado de disponibilidade concluído quando o vendedor forneceu a resposta de disponibilidade para todas as linhas.
STATE_CANCELLED O estado de disponibilidade foi cancelado quando o comprador enviou a solicitação de cancelamento antes de o vendedor fornecer a resposta de disponibilidade para todas as linhas.
STATE_EXPIRED Estado de disponibilidade expirado quando o pedido expirou antes de o vendedor concluí-lo.

Métodos

complete

 Marca um pedido de disponibilidade existente como concluído.

get

 Recupera um pedido de disponibilidade individual.

list

 Lista os pedidos de disponibilidade.