REST Resource: sellers.products

Zasób: Product

Jeden produkt.

Zapis JSON
{
  "name": string,
  "externalId": string,
  "displayName": string,
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "creativeSpecifications": [
    {
      object (CreativeSpecification)
    }
  ],
  "bookingLeadDuration": string,
  "assignmentLeadDuration": string,
  "minFlightDuration": string,
  "maxFlightDuration": string,
  "slotDuration": string,
  "createTime": string,
  "updateTime": string,
  "state": enum (State),
  "currencyCode": string
}
Pola
name

string

Nazwa zasobu produktu w formacie: sellers/{seller}/products/{product}. na przykład sellers/seller111/products/product123.

externalId

string

Identyfikator używany do mapowania tego elementu na źródła zewnętrzne.

displayName

string

Wymagane. Wyświetlana nazwa produktu.

Musi być zakodowany w standardzie UTF-8 i maksymalnym rozmiarze 240 bajtów.

description

string

Dodatkowe dowolne pole do opisania produktu.

labels

map (key: string, value: string)

Zbiór dowolnych etykiet opisujących ten produkt.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

creativeSpecifications[]

object (CreativeSpecification)

Wymagane. Lista dozwolonych kreacji, które mogą być wyświetlane w przypadku tego produktu.

bookingLeadDuration

string (Duration format)

Wymagane. Czas trwania kontaktu do potencjalnego klienta wymagany do zarezerwowania produktu. Teraz + rezerwacjaLeadDuration powinna być późniejsza niż data rozpoczęcia lotu.

Czas trwania w sekundach z maksymalnie dziewięcioma cyframi po przecinku, zakończony znakiem „s”. Przykład: "3.5s".

assignmentLeadDuration

string (Duration format)

Wymagane. Do przypisania kreacji wymagany jest czas trwania potencjalnego klienta.

Czas trwania w sekundach z maksymalnie dziewięcioma cyframi po przecinku, zakończony znakiem „s”. Przykład: "3.5s".

minFlightDuration

string (Duration format)

Minimalny czas lotu dla tej usługi.

Czas trwania w sekundach z maksymalnie dziewięcioma cyframi po przecinku, zakończony znakiem „s”. Przykład: "3.5s".

maxFlightDuration

string (Duration format)

Wymagane. Maksymalny czas trwania lotu tej usługi.

Czas trwania w sekundach z maksymalnie dziewięcioma cyframi po przecinku, zakończony znakiem „s”. Przykład: "3.5s".

slotDuration

string (Duration format)

Wymagane. Czas trwania przedziału dla tej usługi.

Czas trwania w sekundach z maksymalnie dziewięcioma cyframi po przecinku, zakończony znakiem „s”. Przykład: "3.5s".

createTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa utworzenia produktu.

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

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

state

enum (State)

Tylko dane wyjściowe. Stan danego produktu.

currencyCode

string

Wymagane. Trzyliterowy kod waluty pisany wielkimi literami w standardzie ISO 4217.

Stan

Możliwe wartości stanu produktu.

Wartości w polu enum
STATE_UNSPECIFIED Wartość domyślna, gdy stan produktu nie jest określony lub jest nieznany w tej wersji.
STATE_ACTIVE Produkt jest aktywny.
STATE_DELETED Usługa została usunięta.

Metody

create

Tworzy nowy produkt.

delete

Usuwa istniejący produkt.

get

Pobiera pojedynczy produkt.

list

Wyświetla listę produktów.

patch

Aktualizuje istniejący produkt.