REST Resource: availabilityOrders.availabilityLines

Recurso: AvailabilityLine

Una línea de disponibilidad representa un conjunto de parámetros de configuración para los cuales el comprador solicita la disponibilidad del inventario, así como la respuesta del vendedor. Para ver el flujo de trabajo, consulta AvailabilityOrder.

Representación JSON
{
  "name": string,
  "product": string,
  "startTime": string,
  "endTime": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "budget": {
    object (Money)
  },
  "targeting": {
    object (Targeting)
  },
  "availabilityLineTerms": {
    object (LineTerms)
  },
  "state": enum (State),
  "rejection": {
    object (Rejection)
  },
  "createTime": string,
  "updateTime": string
}
Campos
name

string

Solo salida. El nombre del recurso de la línea de disponibilidad en el formato availabilityOrders/123/availabilityLines/321.

product

string

Solo salida. El nombre de Product para esta solicitud de disponibilidad. Formato = productos/456

startTime
(deprecated)

string (Timestamp format)

Solo salida. Es la hora de inicio en la que se solicita la disponibilidad (incluida).

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

endTime
(deprecated)

string (Timestamp format)

Solo salida. La hora de finalización en la que se solicitó la disponibilidad (exclusivo).

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

startDate

object (Date)

Solo salida. Es la fecha de inicio en la que se solicitó la disponibilidad (incluida). Debe tener la misma zona horaria que la unidad de anuncios.

endDate

object (Date)

Solo salida. Es la fecha de finalización en la que se solicitó la disponibilidad (incluida). Debe tener la misma zona horaria que la unidad de anuncios.

budget

object (Money)

Solo salida. Es el presupuesto de la línea de disponibilidad.

targeting

object (Targeting)

Solo salida. Es la segmentación para la que se solicita la disponibilidad.

availabilityLineTerms

object (LineTerms)

Solo salida. Los vendedores pueden usar [Complete][google.ads.xbid.outofhome.v1beta1.OrderManagementService.CompleteAvailabilityLine] para actualizar [LineTerms].

state

enum (State)

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

Los vendedores pueden usar los métodos personalizados [Complete][google.ads.xbid.outofhome.v1beta1.OrderManagementService.CompleteAvailabilityLine] o [Deny][google.ads.xbid.outofhome.v1beta1.OrderManagementService.niAvailabilityLine] para establecer una de las siguientes opciones:

  • STATE_COMPLETED
  • STATE_REJECTED

respectivamente.

rejection

object (Rejection)

Detalles del rechazo de la línea de disponibilidad.

createTime

string (Timestamp format)

Solo salida. Marca de tiempo de creación para la línea de 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".

updateTime

string (Timestamp format)

Solo salida. Marca de tiempo de la última actualización de la línea de 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".

Estado

Valores posibles para el estado de la línea de disponibilidad.

Enumeraciones
STATE_UNSPECIFIED El valor predeterminado cuando no se especificó el estado de la línea 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 completo cuando el vendedor proporcionó la respuesta de disponibilidad.
STATE_REJECTED Estado de rechazo cuando el vendedor rechazó la línea de disponibilidad. Se deben proporcionar los detalles del rechazo.
STATE_CANCELLED Estado cancelado cuando el comprador cancela el pedido antes de que el vendedor complete o rechace la respuesta de disponibilidad.

Métodos

complete

Marca una línea de disponibilidad existente como completada.

get

Recupera una línea individual para un pedido de disponibilidad.

list

Muestra las líneas de un pedido de disponibilidad.

reject

Marca una línea de disponibilidad existente como rechazada.