REST Resource: orders.lines

Risorsa: riga

Una singola riga di ordine che rappresenta un prodotto configurato.

Rappresentazione JSON 
{
  "name": string,
  "product": string,
  "externalId": string,
  "displayName": string,
  "description": string,
  "lineState": enum (LineState),
  "rejection": {
    object (Rejection)
  },
  "startTime": string,
  "endTime": string,
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  },
  "budget": {
    object (Money)
  },
  "lineTerms": {
    object (LineTerms)
  },
  "pendingReservationExpirationTime": string,
  "reservationExpirationTime": string,
  "targeting": {
    object (Targeting)
  },
  "createTime": string,
  "updateTime": string
}
Campi
name

string

Solo output. Il nome della risorsa della riga nel formato: orders/{order_id}/lines/{id}.
product

string

Solo output. Il nome dell'elemento Product che questa riga sta configurando. Formato = products/123
externalId

string

(Facoltativo) Un ID utilizzato per mappare questa entità a origini esterne.
displayName

string

Solo output. Il nome visualizzato della riga.
description

string

Solo output. Campo in formato libero aggiuntivo per descrivere la riga.
lineState

enum (LineState)

Solo output. Stato della linea. Consulta LineState per il ciclo di vita di una linea.

Il venditore può utilizzare i seguenti metodi personalizzati: Reserve, Book e Reject per impostare uno dei seguenti metodi:

  • LINE_STATE_RESERVED
  • LINE_STATE_BOOKED
  • LINE_STATE_REJECTED_BY_SELLER.

Tutti gli altri stati della riga vengono impostati dall'acquirente.
rejection

object (Rejection)

(Facoltativo) Dettagli del rifiuto per la linea.
startTime
(deprecated)

string (Timestamp format)

Solo output. Data di inizio della pubblicazione della riga (incluso).

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
endTime
(deprecated)

string (Timestamp format)

Solo output. Indica quando viene interrotta la pubblicazione della linea (escluso).

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
startDate

object (Date)

Solo output. La data in cui inizierà la pubblicazione della riga (inclusa). Stesso fuso orario dell'unità pubblicitaria.
endDate

object (Date)

Solo output. La data in cui viene interrotta la pubblicazione della riga (inclusa). Stesso fuso orario dell'unità pubblicitaria.
budget

object (Money)

Solo output. Il budget della linea.
lineTerms

object (LineTerms)

Solo output. I termini garantiti del venditore per questa riga.
pendingReservationExpirationTime

string (Timestamp format)

Solo output. Timestamp della scadenza della prenotazione in attesa. Il venditore deve prenotare o rifiutare la prenotazione prima della scadenza, altrimenti verrà considerata rifiutata.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
reservationExpirationTime

string (Timestamp format)

Solo output. Timestamp della scadenza della prenotazione. L'acquirente deve prenotare prima della scadenza di una prenotazione, altrimenti verrà considerata annullata.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
targeting

object (Targeting)

Solo output. Il targeting per la linea.
createTime

string (Timestamp format)

Solo output. Timestamp di creazione per la riga.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo aggiornamento della riga.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

LineState

Stato di una linea.

Enum
LINE_STATE_UNSPECIFIED Il valore predefinito quando lo stato della riga non è stato specificato o è sconosciuto in questa versione.
LINE_STATE_PENDING_RESERVATION La riga è stata creata dall'acquirente e richiede la prenotazione dei prodotti e l'aggiornamento con informazioni su prezzi e disponibilità.
LINE_STATE_RESERVED La riga è stata prenotata dal venditore. Questo stato è possibile solo se lo stato precedente è in attesa di prenotazione.
LINE_STATE_PENDING_BOOKING L'acquirente ha accettato la prenotazione e chiede di prenotare la linea.
LINE_STATE_BOOKED Il venditore ha prenotato la linea. Questo stato è possibile solo se lo stato precedente è in attesa di prenotazione. In questa fase non sono previsti rifiuti.
LINE_STATE_REJECTED_BY_SELLER La riga è stata rifiutata dal venditore. Questo stato è possibile solo se lo stato precedente è in attesa di prenotazione.
LINE_STATE_CANCELLED_BY_BUYER La riga è stata annullata dall'acquirente.
LINE_STATE_PENDING_RESERVATION_EXPIRED La riga è scaduta mentre è in attesa della prenotazione.
LINE_STATE_RESERVED_EXPIRED La riga è scaduta durante la prenotazione, in attesa della risposta dell'acquirente.

Metodi

book

 Prenota una riga esistente.

get

 Recupera una singola riga di un ordine.

list

 Elenca le righe di un ordine.

patch

 Aggiorna una riga esistente.

reject

 Rifiuta una linea esistente.

reserve

 Prenota una linea esistente.