REST Resource: availabilityOrders

Risorsa: Ordine disponibilità

Un ordine di disponibilità è una raccolta di AvailabilityLines. L'ordine di disponibilità viene creato dall'acquirente. Il venditore aggiorna la disponibilità con la risposta.

Il flusso di lavoro è il seguente:

  • L'acquirente crea l'ordine e le righe di disponibilità e imposta lo stato su In attesa. Non sono consentite ulteriori modifiche dell'acquirente all'ordine di disponibilità o alla riga.
  • Il venditore agisce su tutte le righe di disponibilità completando i termini di disponibilità o contrassegnando come rifiutato. Le azioni di completamento o rifiuto sono possibili solo quando l'ordine e le righe sono in stato In attesa.
  • Il venditore utilizza complete azione personalizzata per contrassegnare la richiesta di disponibilità come completata. Una volta completate, non è più possibile apportare ulteriori modifiche all'ordine di disponibilità o alle righe secondarie.
Rappresentazione JSON 
{
  "name": string,
  "description": string,
  "state": enum (State),
  "pendingExpirationTime": string,
  "createTime": string,
  "updateTime": string,
  "advertiserInfo": {
    object (AdvertiserInfo)
  }
}
Campi
name

string

Solo output. Il nome della risorsa dell'ordine di disponibilità nel formato: availabilityOrders/{id}.
description

string

Solo output. Campo in formato libero aggiuntivo per descrivere l'ordine di disponibilità.
state

enum (State)

Solo output. Lo stato di questo ordine di disponibilità. Consulta AvailabilityOrder.State per il ciclo di vita di un Ordine di disponibilità.

Il venditore può utilizzare il metodo personalizzato Complete per impostare STATE_COMPLETED.
pendingExpirationTime

string (Timestamp format)

Solo output. Timestamp della scadenza dell'ordine di disponibilità in attesa. Un ordine in attesa di disponibilità deve essere completato prima della scadenza, altrimenti verrà considerato completo senza disponibilità.

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

string (Timestamp format)

Solo output. Timestamp della creazione. Assegnato dal sistema.

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. Assegnato dal sistema.

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

object (AdvertiserInfo)

Solo output. Informazioni sull'inserzionista.

Stato

Valori possibili per lo stato dell'ordine di disponibilità.

Enum
STATE_UNSPECIFIED Il valore predefinito quando lo stato dell'ordine di disponibilità non è stato specificato o è sconosciuto in questa versione.
STATE_PENDING Disponibilità in attesa quando l'acquirente ha fornito le impostazioni della richiesta di disponibilità.
STATE_COMPLETED Stato di disponibilità completato quando il venditore ha fornito la risposta relativa alla disponibilità per tutte le righe.
STATE_CANCELLED Stato di disponibilità annullata quando l'acquirente ha fornito la richiesta di annullamento prima che il venditore fornisse la risposta sulla disponibilità per tutte le righe.
STATE_EXPIRED Stato di disponibilità scaduto quando l'ordine è scaduto prima che il venditore l'avesse completato.

Metodi

complete

 Contrassegna un ordine di disponibilità esistente come completato.

get

 Recupera un singolo ordine di disponibilità.

list

 Elenca gli ordini relativi alla disponibilità.