REST Resource: availabilityOrders

Zasób: AvailabilityOrder

Zamówienie na dostępność to kolekcja AvailabilityLines. Zamówienie na dostępność jest tworzone przez kupującego. Sprzedawca aktualizuje dostępność za pomocą tej odpowiedzi.

Przepływ pracy wygląda tak:

  • Kupujący tworzy zamówienie i wiersze dostępności oraz ustawia stan na Oczekujący. Dalsze zmiany kupującego w zamówieniu lub zamówieniu dotyczącym dostępności są niedozwolone.
  • Sprzedawca działa na wszystkich liniach dostępności, podając warunki dostępności lub oznaczając je jako odrzucone. Wykonywanie i odrzucanie działań jest możliwe tylko wtedy, gdy zamówienie i pozycje są w stanie oczekiwania.
  • Sprzedawca używa działania niestandardowego complete do oznaczenia prośby o dostępność jako zrealizowanej. Dalsze zmiany w zamówieniu dostępności lub w wierszach podrzędnych nie są dozwolone po zakończeniu tego procesu.
Zapis JSON 
{
  "name": string,
  "description": string,
  "state": enum (State),
  "pendingExpirationTime": string,
  "createTime": string,
  "updateTime": string,
  "advertiserInfo": {
    object (AdvertiserInfo)
  }
}
Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu zamówienia na zamówienie dostępności w formacie: availabilityOrders/{id}.
description

string

Tylko dane wyjściowe. Dodatkowe pole do opisania kolejności dostępności.
state

enum (State)

Tylko dane wyjściowe. Stan tego zamówienia dotyczącego dostępności. Zapoznaj się z AvailabilityOrder.State dotyczącymi cyklu życia AvailabilityOrder.

Sprzedawca może użyć metody niestandardowej Complete, aby ustawić wartość STATE_COMPLETED.
pendingExpirationTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa wygaśnięcia oczekującego zamówienia dostępności. Sprzedawca musi zakończyć ten proces, zanim zamówienie oczekujące na dostępność wygaśnie. W przeciwnym razie zamówienie zostanie uznane za kompletne i brak dostępności.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
createTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa utworzenia. Przypisana przez system.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa ostatniej aktualizacji. Przypisana przez system.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
advertiserInfo

object (AdvertiserInfo)

Tylko dane wyjściowe. Informacje o reklamodawcy.

Stan

Możliwe wartości stanu zamówienia dostępności.

Wartości w polu enum
STATE_UNSPECIFIED Wartość domyślna, gdy stan zamówienia dostępności nie został określony lub jest nieznany w tej wersji.
STATE_PENDING Oczekuje na dostępność, gdy kupujący podał ustawienia żądania dostępności.
STATE_COMPLETED Stan dostępności, w którym sprzedawca podał odpowiedź dotyczącą dostępności we wszystkich wierszach.
STATE_CANCELLED Stan dostępności, gdy kupujący przekazał żądanie anulowania, zanim sprzedawca podał odpowiedź o dostępności dla wszystkich wierszy.
STATE_EXPIRED Stan dostępności wygasł, gdy zamówienie wygasło, zanim sprzedawca je zrealizował.

Metody

complete

 Oznacza istniejące zamówienie dostępności jako ukończone.

get

 Pobiera indywidualne zamówienie dostępności.

list

 Wyświetla listę zamówień dostępności.