REST Resource: availabilityOrders.availabilityLines

Zasób: AvailabilityLine

Linia dostępności reprezentuje zestaw ustawień, dla których kupujący wysyła żądanie dostępności zasobów reklamowych i uzyska odpowiedź od sprzedawcy. Instrukcje znajdziesz tutaj: AvailabilityOrder.

Zapis 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
}
Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu wiersza dostępności w formacie: availabilityOrders/123/availabilityLines/321.

product

string

Tylko dane wyjściowe. Nazwa Product, którego dotyczy ta prośba o dostępność. Format = products/456

startTime
(deprecated)

string (Timestamp format)

Tylko dane wyjściowe. Godzina rozpoczęcia żądania dostępności (włącznie).

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

endTime
(deprecated)

string (Timestamp format)

Tylko dane wyjściowe. Godzina zakończenia żądania dostępności (z wyłączeniem).

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

startDate

object (Date)

Tylko dane wyjściowe. Data rozpoczęcia żądania dostępności (włącznie z tym dniem). Ta sama strefa czasowa co w jednostce reklamowej.

endDate

object (Date)

Tylko dane wyjściowe. Data zakończenia prośby o dostępność (włącznie z tym terminem). Ta sama strefa czasowa co w jednostce reklamowej.

budget

object (Money)

Tylko dane wyjściowe. Budżet linii dostępności.

targeting

object (Targeting)

Tylko dane wyjściowe. Kierowanie, dla którego zażądano dostępności.

availabilityLineTerms

object (LineTerms)

Tylko dane wyjściowe. Sprzedawca może użyć [Complete][google.ads.xbid.outofhome.v1beta1.OrderManagementService.CompleteAvailabilityLine] do aktualizacji [LineTerms].

state

enum (State)

Tylko dane wyjściowe. Stan tego zamówienia dotyczącego dostępności. Informacje o cyklu życia elementu AvailabilityLine znajdziesz w AvailabilityLine.State.

Sprzedawca może użyć niestandardowych metod [Complete][google.ads.xbid.outofhome.v1beta1.OrderManagementService.CompleteAvailabilityLine] lub [Odrzuć][google.ads.xbid.outofhome.v1beta1.OrderManagementService.BounceAvailabilityLine], aby ustawić jedną z tych metod:

  • STATE_COMPLETED
  • STATE_REJECTED

.

rejection

object (Rejection)

Szczegóły odrzucenia dla linii dostępności.

createTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa utworzenia linii 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".

updateTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa ostatniej aktualizacji linii 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".

Stan

Możliwe wartości stanu linii dostępności.

Wartości w polu enum
STATE_UNSPECIFIED Wartość domyślna, gdy stan linii 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, w którym sprzedawca podał odpowiedź dotyczącą dostępności.
STATE_REJECTED Stan odrzucenia, gdy linia dostępności została odrzucona przez sprzedawcę. Należy podać szczegóły dotyczące odrzucenia.
STATE_CANCELLED Stan anulowany, gdy kupujący anuluje zamówienie przed ukończeniem przez sprzedawcę lub odrzuci odpowiedź o dostępności.

Metody

complete

Oznacza istniejący wiersz dostępności jako ukończony.

get

Pobiera pojedynczy wiersz zamówienia dostępności.

list

Zawiera listę wierszy zamówienia dotyczącego dostępności.

reject

Oznacza istniejący wiersz dostępności jako odrzucony.