REST Resource: sellers.availabilityOrders

Recurso: AvailabilityOrder

Un pedido de disponibilidad es una colección de AvailabilityLines. El comprador crea el pedido de disponibilidad. El vendedor actualiza la disponibilidad con la respuesta.

El flujo de trabajo es el siguiente:

  • El comprador crea líneas y pedido de disponibilidad, y establece el estado como pendiente. No se permiten otros cambios del comprador en el pedido o la línea de disponibilidad.
  • El vendedor actúa en todas las líneas de disponibilidad, ya sea completando las condiciones de disponibilidad o marcándolas como rechazadas. Las acciones de completar o rechazar solo son posibles cuando el pedido y las líneas están en estado pendiente.
  • El vendedor usa la acción personalizada complete para marcar la solicitud de disponibilidad como completada. Una vez que se completen, no se podrán realizar más cambios en el orden de disponibilidad ni en las líneas secundarias.
Representación JSON 
{
  "name": string,
  "description": string,
  "state": enum (State),
  "expireTime": string,
  "createTime": string,
  "updateTime": string,
  "advertiserInfo": {
    object (AdvertiserInfo)
  }
}
Campos
name

string

Solo salida. El nombre del recurso del orden de disponibilidad en el formato sellers/{seller}/availabilityOrders/{id}.
description

string

Solo salida. Es el campo de formato libre adicional para describir el pedido de disponibilidad.
state

enum (State)

Solo salida. Es el estado de este pedido de disponibilidad. Consulta AvailabilityOrder.State para ver el ciclo de vida de un AvailabilityOrder.

El vendedor puede usar el método personalizado Complete para establecerlo en STATE_COMPLETED.
expireTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de vencimiento del pedido de disponibilidad pendiente. El vendedor debe completar el pedido antes de que venza un pedido de disponibilidad pendiente. De lo contrario, se lo considerará completo y sin disponibilidad.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
createTime

string (Timestamp format)

Solo salida. Marca de tiempo de creación Asignada por el sistema.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Solo salida. Marca de tiempo de la última actualización Asignada por el sistema.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
advertiserInfo

object (AdvertiserInfo)

Solo salida. Información del anunciante

Estado

Valores posibles para el estado del pedido de disponibilidad.

Enumeraciones
STATE_UNSPECIFIED El valor predeterminado cuando no se especificó el estado del pedido de disponibilidad o se desconoce en esta versión.
STATE_PENDING La disponibilidad está pendiente cuando el comprador proporcionó la configuración de solicitud de disponibilidad.
STATE_COMPLETED Estado de disponibilidad completo cuando el vendedor proporcionó la respuesta de disponibilidad para todas las líneas.
STATE_CANCELLED Estado de disponibilidad cancelado cuando el comprador proporcionó la solicitud de cancelación antes de que el vendedor proporcionara la respuesta de disponibilidad para todas las líneas.
STATE_EXPIRED Es el estado de disponibilidad vencido cuando venció el pedido antes de que el vendedor lo completara.

Métodos

complete

 Marca un pedido de disponibilidad existente como completado.

get

 Recupera un pedido de disponibilidad individual.

list

 Muestra una lista de los pedidos de disponibilidad.