REST Resource: accounts.shippingSettings

Zasób: ShippingSettings

ustawienia dostawy na koncie sprzedawcy.

Zapis JSON
{
  "name": string,
  "services": [
    {
      object (Service)
    }
  ],
  "warehouses": [
    {
      object (Warehouse)
    }
  ],
  "etag": string
}
Pola
name

string

Identyfikator. Nazwa zasobu ustawienia dostawy. Format: accounts/{account}/shippingSetting

services[]

object (Service)

Opcjonalnie: Lista usług konta docelowego.

warehouses[]

object (Warehouse)

Opcjonalnie: Lista magazynów, do których można się odwoływać w sekcji services.

etag

string

Wymagane. To pole służy do unikania problemów z asynchronicznością. Upewnij się, że dane ustawień dostawy nie uległy zmianie między wywołaniem funkcji get call a wstawianiem funkcji insert call. Użytkownik powinien wykonać te czynności:

  1. Podczas tworzenia początkowych ustawień dostawy ustaw pole etag jako pusty ciąg znaków.

  2. Po utworzeniu metody wywołania wywołaj metodę get, aby uzyskać etag i bieżące dane ustawień dostawy przed wywołaniem insert.

  3. Zmień na żądane ustawienia dostawy.

  4. Zadzwoń do metody wstawiania z żądanymi informacjami o ustawieniach dostawy i tagiem eTag uzyskanym w kroku 2.

  5. Jeśli dane dotyczące ustawień dostawy uległy zmianie między krokiem 2 a krokiem 4. Żądanie wstawienia nie powiedzie się, ponieważ tag zmienia się za każdym razem, gdy zmieniają się dane ustawień dostawy. Użytkownik powinien powtórzyć kroki 2–4, używając nowego znacznika etag.

Usługa

Usługa dostawy.

Zapis JSON
{
  "deliveryCountries": [
    string
  ],
  "rateGroups": [
    {
      object (RateGroup)
    }
  ],
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "serviceName": string,
  "active": boolean,
  "currencyCode": string,
  "deliveryTime": {
    object (DeliveryTime)
  },
  "shipmentType": enum (ShipmentType),
  "minimumOrderValue": {
    object (Price)
  },
  "minimumOrderValueTable": {
    object (MinimumOrderValueTable)
  },
  "storeConfig": {
    object (StoreConfig)
  }
}
Pola
deliveryCountries[]

string

Wymagane. Kod regionu CLDR krajów, w których obowiązuje usługa.

rateGroups[]

object (RateGroup)

Opcjonalnie: Definicje grup stawek dostawy. Tylko ostatnia grupa może mieć pustą wartość applicableShippingLabels, co oznacza „wszystko inne”. Inne applicableShippingLabels nie mogą się nakładać.

loyaltyPrograms[]

object (LoyaltyProgram)

Opcjonalnie: Programy lojalnościowe, w przypadku których usługa dostawy jest ograniczona.

serviceName

string

Wymagane. Wolnoformowa nazwa usługi. Musi być niepowtarzalny na koncie docelowym.

active

boolean

Wymagane. Wartość logiczna określająca aktywny stan usługi dostawy.

currencyCode

string

Kod CLDR waluty, której dotyczy ta usługa. Musi być zgodna z cenami w grupach stawek.

deliveryTime

object (DeliveryTime)

Wymagane. Czas spędzony na różnych etapach od zamówienia do dostawy produktu.

shipmentType

enum (ShipmentType)

Typy lokalizacji, do których usługa wysyła zamówienia.

minimumOrderValue

object (Price)

Minimalna wartość zamówienia dla tej usługi. Jeśli jest ustawiona, oznacza, że klienci muszą wydać co najmniej tę kwotę. Wszystkie ceny w ramach usługi muszą być podane w tej samej walucie. Nie można go ustawić razem z minimumOrderValueTable.

minimumOrderValueTable

object (MinimumOrderValueTable)

Tabela minimalnych wartości zamówień w poszczególnych sklepach w przypadku typu realizacji zamówienia „Odbiór w sklepie”. Nie można go ustawić razem z minimumOrderValue.

storeConfig

object (StoreConfig)

Lista sklepów, z których dostarczane są Twoje produkty. Dotyczy to tylko dostawy lokalnej.

DeliveryTime

Czas spędzony na różnych etapach od zamówienia do dostawy produktu.

Zapis JSON
{
  "warehouseBasedDeliveryTimes": [
    {
      object (WarehouseBasedDeliveryTime)
    }
  ],
  "minTransitDays": integer,
  "maxTransitDays": integer,
  "cutoffTime": {
    object (CutoffTime)
  },
  "minHandlingDays": integer,
  "maxHandlingDays": integer,
  "transitTimeTable": {
    object (TransitTable)
  },
  "handlingBusinessDayConfig": {
    object (BusinessDayConfig)
  },
  "transitBusinessDayConfig": {
    object (BusinessDayConfig)
  }
}
Pola
warehouseBasedDeliveryTimes[]

object (WarehouseBasedDeliveryTime)

Opcjonalnie: Wskazuje, że czas dostawy powinien być obliczany dla każdego magazynu (miejsca wysyłki) na podstawie ustawień wybranego przewoźnika. Jeśli to pole jest ustawione, żadne inne pole związane z czasem dostawy w [delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] nie powinno być ustawione.

minTransitDays

integer

Minimalna liczba dni roboczych, które mijają podczas transportu. 0 oznacza dostawę tego samego dnia, a 1 oznacza dostawę następnego dnia. Musisz ustawić wartość minTransitDays, maxTransitDays lub transitTimeTable, ale nie obie.

maxTransitDays

integer

Maksymalna liczba dni roboczych na czas przewozu. 0 oznacza dostawę tego samego dnia, a 1 oznacza dostawę następnego dnia. Musi być równa lub większa niż minTransitDays.

cutoffTime

object (CutoffTime)

Definicja czasu granicznych w dniach roboczych. Jeśli nie skonfigurujesz tego ustawienia, domyślnie będzie to godzina 8:00 czasu PST.

minHandlingDays

integer

Minimalna liczba dni roboczych przed wysłaniem zamówienia. 0 oznacza wysyłkę tego samego dnia, 1 oznacza wysyłkę następnego dnia. Wartości „minHandlingDays” i „maxHandlingDays” powinny być ustawione lub nieskonfigurowane w tym samym czasie.

maxHandlingDays

integer

Maksymalna liczba dni roboczych przed wysłaniem zamówienia. 0 oznacza wysyłkę tego samego dnia, 1 oznacza wysyłkę następnego dnia. Musi być równa lub większa niż minHandlingDays. Wartości „minHandlingDays” i „maxHandlingDays” powinny być ustawione lub nie ustawione w tym samym czasie.

transitTimeTable

object (TransitTable)

Tabela Czas przewozu, liczba dni roboczych spędzonych w transporcie na podstawie wymiarów wiersza i kolumny. Możesz ustawić wartość minTransitDays, maxTransitDays lub transitTimeTable, ale nie obie.

handlingBusinessDayConfig

object (BusinessDayConfig)

Dni robocze, w których można realizować zamówienia. Jeśli nie podasz tej informacji, przyjmiemy, że godziny pracy to od poniedziałku do piątku.

transitBusinessDayConfig

object (BusinessDayConfig)

Dni robocze, w których zamówienia mogą być w drodze. Jeśli nie podasz tej informacji, przyjmiemy, że godziny pracy to od poniedziałku do piątku.

CutoffTime

Definicja czasu granicznych w dniach roboczych.

Zapis JSON
{
  "hour": integer,
  "minute": integer,
  "timeZone": string
}
Pola
hour

integer

Wymagane. Godzina, do której należy złożyć zamówienie, aby zostało ono zrealizowane tego samego dnia.

minute

integer

Wymagane. Minuta ostatecznego terminu, do którego należy złożyć zamówienie, aby zostało ono zrealizowane tego samego dnia.

timeZone

string

Wymagane. Identyfikator strefy czasowej, np. „Europe/Zurich”.

TransitTable

Tabela Czas przewozu, liczba dni roboczych spędzonych w transporcie na podstawie wymiarów wiersza i kolumny. Możesz ustawić wartość minTransitDays, maxTransitDays lub transitTimeTable, ale nie obie.

Zapis JSON
{
  "postalCodeGroupNames": [
    string
  ],
  "transitTimeLabels": [
    string
  ],
  "rows": [
    {
      object (TransitTimeRow)
    }
  ]
}
Pola
postalCodeGroupNames[]

string

Wymagane. Lista nazw regionów Region.name . Ostatnia wartość może wynosić "all other locations". Przykład: ["zone 1", "zone 2", "all other locations"]. Wskazywane grupy kodów pocztowych muszą być zgodne z krajem dostawy usługi.

transitTimeLabels[]

string

Wymagane. Lista etykiet czasu przewozu. Ostatnia wartość może wynosić "all other labels". Przykład: ["food", "electronics", "all other labels"].

rows[]

object (TransitTimeRow)

Wymagane. Jeśli występuje tylko 1 zbiór wymiarów postalCodeGroupNames lub transitTimeLabels, w przypadku tego wymiaru występuje kilka wierszy, z których każdy ma po 1 wartości. Jeśli są 2 wymiary, każdy wiersz odpowiada postalCodeGroupNames, a kolumny (wartości) – transitTimeLabels.

TransitTimeRow

Jeśli występuje tylko 1 zbiór wymiarów postalCodeGroupNames lub transitTimeLabels, w przypadku tego wymiaru występuje kilka wierszy, z których każdy ma po 1 wartości. Jeśli są 2 wymiary, każdy wiersz odpowiada postalCodeGroupNames, a kolumny (wartości) – transitTimeLabels.

Zapis JSON
{
  "values": [
    {
      object (TransitTimeValue)
    }
  ]
}
Pola
values[]

object (TransitTimeValue)

Wymagane. Zakres czasu przewozu (min-max) w dniach roboczych.

TransitTimeValue

Zakres czasu przewozu (min-max) w dniach roboczych.

Zapis JSON
{
  "minTransitDays": integer,
  "maxTransitDays": integer
}
Pola
minTransitDays

integer

Minimalny czas przewozu w dniach roboczych. 0 oznacza dostawę tego samego dnia, a 1 oznacza dostawę następnego dnia.

maxTransitDays

integer

Musi być równa lub większa niż minTransitDays.

BusinessDayConfig

dni roboczych magazynu;

Zapis JSON
{
  "businessDays": [
    enum (Weekday)
  ]
}
Pola
businessDays[]

enum (Weekday)

Wymagane. Standardowe dni robocze. Nie może być pusta.

Dzień tygodnia

Wartości w polu enum
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

WarehouseBasedDeliveryTime

Wskazuje, że czas dostawy powinien być obliczany dla każdego magazynu (miejsca wysyłki) na podstawie ustawień wybranego przewoźnika. Gdy to pole jest ustawione, nie należy ustawiać żadnych innych pól związanych z czasem przewozu w deliveryTime.

Zapis JSON
{
  "carrier": string,
  "carrierService": string,
  "warehouse": string
}
Pola
carrier

string

Wymagane. Operator, np. "UPS" lub "Fedex". obsługiwani operatorzy

carrierService

string

Wymagane. Usługa operatora, np. "ground" lub "2 days". Nazwa usługi musi znajdować się na liście eddSupportedServices.

warehouse

string

Wymagane. Nazwa magazynu. Powinna być zgodna z [warehouse][ShippingSetting.warehouses.name]

RateGroup

Definicje grup stawek dostawy. Tylko ostatnia grupa może mieć pustą wartość applicableShippingLabels, co oznacza „wszystko inne”. Inne applicableShippingLabels nie mogą się nakładać.

Zapis JSON
{
  "applicableShippingLabels": [
    string
  ],
  "subtables": [
    {
      object (Table)
    }
  ],
  "carrierRates": [
    {
      object (CarrierRate)
    }
  ],
  "singleValue": {
    object (Value)
  },
  "mainTable": {
    object (Table)
  },
  "name": string
}
Pola
applicableShippingLabels[]

string

Wymagane. Lista etykiet wysyłki określająca produkty, do których ma zastosowanie ta grupa stawek. Jest to dysjunkcja: aby grupa stawek mogła zostać zastosowana, musi pasować tylko jedna z etykietek. Może być pusta tylko w przypadku ostatniej grupy stawek usługi.

subtables[]

object (Table)

Opcjonalnie: Lista podtablic, do których odwołuje się mainTable. Można ustawić tylko wtedy, gdy ustawiono wartość mainTable.

carrierRates[]

object (CarrierRate)

Opcjonalnie: Lista stawek operatora, do których można się odwołać za pomocą pola mainTable lub singleValue.

singleValue

object (Value)

Wartość grupy stawek (np. stała stawka 10 zł). Można ustawić tylko wtedy, gdy mainTable i subtables nie są ustawione.

mainTable

object (Table)

Tabela definiująca grupę stawek, gdy singleValue nie jest wystarczająco precyzyjna. Można ustawić tylko wtedy, gdy nie jest ustawiona wartość singleValue.

name

string

Opcjonalnie: Nazwa grupy stawek. Jeśli zestaw musi być niepowtarzalny w ramach usługi dostawy.

Wartość

Pojedyncza wartość grupy stawek lub wartość komórki tabeli grupy stawek. Dokładnie jeden z tych parametrów: noShipping, flatRate, pricePercentage, carrier_rateName, subtable_name musi być ustawiony.

Zapis JSON
{
  "noShipping": boolean,
  "flatRate": {
    object (Price)
  },
  "pricePercentage": string,
  "carrierRate": string,
  "subtable": string
}
Pola
noShipping

boolean

Jeśli wartość to prawda, produkt nie może być wysyłany. Gdy jest ustawione, musi mieć wartość Prawda. Można je ustawić tylko wtedy, gdy wszystkie inne pola są puste.

flatRate

object (Price)

Stawka stała. Można je ustawić tylko wtedy, gdy wszystkie pozostałe pola są puste.

pricePercentage

string

Odsetek ceny reprezentowany jako liczba w zapisie dziesiętnym (np. "5.4"). Można go ustawić tylko wtedy, gdy wszystkie inne pola są puste.

carrierRate

string

Nazwa stawki przewoźnika odwołującej się do stawki przewoźnika zdefiniowanej w tej samej grupie stawek. Można je ustawić tylko wtedy, gdy wszystkie pozostałe pola są puste.

subtable

string

Nazwa podtabeli. Można je ustawiać tylko w komórkach tabeli (nie w przypadku pojedynczych wartości) i tylko wtedy, gdy wszystkie pozostałe pola są puste.

Tabela

Tabela definiująca grupę stawek, gdy singleValue nie jest wystarczająco precyzyjna.

Zapis JSON
{
  "rows": [
    {
      object (Row)
    }
  ],
  "name": string,
  "rowHeaders": {
    object (Headers)
  },
  "columnHeaders": {
    object (Headers)
  }
}
Pola
rows[]

object (Row)

Wymagane. Lista wierszy, które tworzą tabelę. Musi mieć taką samą długość jak rowHeaders.

name

string

Nazwa tabeli. Wymagane w przypadku podtabel, ignorowane w przypadku tabeli głównej.

rowHeaders

object (Headers)

Wymagane. Nagłówki wierszy tabeli.

columnHeaders

object (Headers)

Nagłówki kolumn tabeli. Opcjonalnie: jeśli nie jest ustawiony, tabela ma tylko 1 wymiar.

Nagłówki

Niepusta lista nagłówków wierszy lub kolumn tabeli. Musisz ustawić dokładnie jedną z tych opcji: prices, weights, num_items, postalCodeGroupNames lub location.

Zapis JSON
{
  "prices": [
    {
      object (Price)
    }
  ],
  "weights": [
    {
      object (Weight)
    }
  ],
  "numberOfItems": [
    string
  ],
  "postalCodeGroupNames": [
    string
  ],
  "locations": [
    {
      object (LocationIdSet)
    }
  ]
}
Pola
prices[]

object (Price)

Wymagane. Lista górnych granic cen zamówień z wliczonym podatkiem. Wartość ostatniej ceny może być nieskończona, jeśli ustawisz parametr price amountMicros = -1. Na przykład [{"amountMicros": 10000000, "currencyCode": "USD"}, {"amountMicros": 500000000, "currencyCode": "USD"}, {"amountMicros": -1, "currencyCode": "USD"}] oznacza nagłówki „<= 10 zł”, „<= 500 zł” i „> 500 zł”. Wszystkie ceny w ramach usługi muszą być podane w tej samej walucie. Nie może być puste. Musi być dodatni, z wyjątkiem wartości -1. Można je ustawić tylko wtedy, gdy wszystkie pozostałe pola są puste.

weights[]

object (Weight)

Wymagane. Lista górnych granic wag zamówienia włącznie. Wartość ostatniego obciążenia może być nieskończona, jeśli ustawisz parametr price amountMicros = -1. Na przykład [{"amountMicros": 10000000, "unit": "kg"}, {"amountMicros": 50000000, "unit": "kg"}, {"amountMicros": -1, "unit": "kg"}] reprezentuje nagłówki „<= 10kg”, „<= 50kg” i „> 50kg”. Wszystkie wagi w ramach usługi muszą mieć tę samą jednostkę. Nie może być puste. Musi być dodatni, z wyjątkiem wartości -1. Można je ustawić tylko wtedy, gdy wszystkie pozostałe pola są puste.

numberOfItems[]

string

Wymagane. Lista górnych granic liczby elementów. Ostatnia wartość może wynosić "infinity". Na przykład ["10", "50", "infinity"] reprezentuje nagłówki „<= 10 items” (do 10 elementów), „<= 50 items” (do 50 elementów) i „> 50 items” (powyżej 50 elementów). Nie może być puste. Można je ustawić tylko wtedy, gdy wszystkie pozostałe pola są puste.

postalCodeGroupNames[]

string

Wymagane. Lista nazw grup pocztowych. Ostatnia wartość może wynosić "all other locations". Przykład: ["zone 1", "zone 2", "all other locations"]. Wskazywane grupy kodów pocztowych muszą być zgodne z krajem dostawy usługi. Nie może być puste. Można je ustawić tylko wtedy, gdy wszystkie pozostałe pola są puste.

locations[]

object (LocationIdSet)

Wymagane. Lista zestawów identyfikatorów lokalizacji. Nie może być puste. Można je ustawić tylko wtedy, gdy wszystkie pozostałe pola są puste.

Waga

Waga jako wartość w ciągu i jednostce.

Zapis JSON
{
  "unit": enum (WeightUnit),
  "amountMicros": string
}
Pola
unit

enum (WeightUnit)

Wymagane. Jednostka wagi. Akceptowane wartości to kg i lb

amountMicros

string (int64 format)

Wymagane. waga wyrażona jako liczba w mikrosach (1 mln mikrosów odpowiada jednej standardowej jednostce waluty, np. 1 kg = 1000000 mikrosów). To pole można też ustawić jako nieskończoność, ustawiając wartość –1. To pole obsługuje tylko wartość -1 i dodatnie wartości.

WeightUnit

Jednostka wagi.

Wartości w polu enum
WEIGHT_UNIT_UNSPECIFIED jednostka nieokreślona
POUND funta
KILOGRAM kg.

LocationIdSet

Lista zestawów identyfikatorów lokalizacji. Nie może być puste. Można je ustawić tylko wtedy, gdy wszystkie pozostałe pola są puste.

Zapis JSON
{
  "locationIds": [
    string
  ]
}
Pola
locationIds[]

string

Wymagane. Niepusta lista identyfikatorów lokalizacji. Wszystkie muszą być tego samego typu (np. stan).

Wiersz

Uwzględnij listę komórek.

Zapis JSON
{
  "cells": [
    {
      object (Value)
    }
  ]
}
Pola
cells[]

object (Value)

Wymagane. Lista komórek, które tworzą wiersz. W przypadku tabel dwuwymiarowych musi mieć taką samą długość jak columnHeaders, a w przypadku tabel jednowymiarowych – długość 1.

CarrierRate

Lista stawek operatora, do których można się odwołać za pomocą pola mainTable lub singleValue. Obsługiwane usługi operatora zostały zdefiniowane na stronie https://support.google.com/merchants/answer/12577710?hl=en&ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.

Zapis JSON
{
  "name": string,
  "carrier": string,
  "carrierService": string,
  "originPostalCode": string,
  "percentageAdjustment": string,
  "flatAdjustment": {
    object (Price)
  }
}
Pola
name

string

Wymagane. Nazwa stawki przewoźnika. Musi być unikalny w przypadku każdej grupy stawek.

carrier

string

Wymagane. Usługa operatora, np. "UPS" lub "Fedex".

carrierService

string

Wymagane. Usługa operatora, np. "ground" lub "2 days".

originPostalCode

string

Wymagane. Miejsce nadania przesyłki dla tego przewoźnika.

percentageAdjustment

string

Opcjonalnie: Multiplikatywny modyfikator stawki dostawy podany jako liczba w zapisie dziesiętnym. Może być ujemna. Na przykład "5.4" zwiększa stawkę o 5,4%, a "-3" ją obniża o 3%.

flatAdjustment

object (Price)

Opcjonalnie: Dodatni modyfikator stawki dostawy. Może być ujemna. Na przykład { "amountMicros": 1, "currencyCode" : "USD" } zwiększa stawkę o 1 zł, a { "amountMicros": -3, "currencyCode" : "USD" } zmniejsza ją o 3 zł.

ShipmentType

Typ przesyłki usługi dostawy.

Wartości w polu enum
SHIPMENT_TYPE_UNSPECIFIED Ta usługa nie określa typu przesyłki.
DELIVERY Ta usługa umożliwia wysyłkę zamówień na adres wybrany przez klienta.
LOCAL_DELIVERY Ta usługa umożliwia wysyłkę zamówień na adres wybrany przez klienta. Zamówienie jest wysyłane z lokalnego sklepu w pobliżu.
COLLECTION_POINT Ta usługa umożliwia wysyłkę zamówień na adres wybrany przez klienta. Zamówienie jest wysyłane z punktu odbioru.

MinimumOrderValueTable

Tabela minimalnych wartości zamówień w poszczególnych sklepach w przypadku typu realizacji zamówienia „Odbiór w sklepie”.

Zapis JSON
{
  "storeCodeSetWithMovs": [
    {
      object (StoreCodeSetWithMov)
    }
  ]
}
Pola
storeCodeSetWithMovs[]

object (StoreCodeSetWithMov)

Wymagane. Lista zestawów kodów sklepów o tej samej minimalnej wartości zamówienia (MOV). Wymagane są co najmniej 2 zestawy, a ostatnia musi być pusta, co oznacza „MOV dla wszystkich pozostałych sklepów”. Każdy kod sklepu może wystąpić tylko raz we wszystkich zestawach. Wszystkie ceny w ramach usługi muszą być podane w tej samej walucie.

StoreCodeSetWithMov

Lista zestawów kodów sklepów o tej samej minimalnej wartości zamówienia. Wymagane są co najmniej 2 zestawy, a ostatnia musi być pusta, co oznacza „MOV dla wszystkich pozostałych sklepów”. Każdy kod sklepu może wystąpić tylko raz we wszystkich zestawach. Wszystkie ceny w ramach usługi muszą być podane w tej samej walucie.

Zapis JSON
{
  "storeCodes": [
    string
  ],
  "value": {
    object (Price)
  }
}
Pola
storeCodes[]

string

Opcjonalnie: Lista unikalnych kodów sklepów lub pusta lista dla wszystkich sklepów.

value

object (Price)

Minimalna wartość zamówienia w danych sklepach.

StoreConfig

Lista sklepów, z których dostarczane są Twoje produkty. Dotyczy to tylko dostawy lokalnej.

Zapis JSON
{
  "storeCodes": [
    string
  ],
  "storeServiceType": enum (StoreServiceType),
  "cutoffConfig": {
    object (CutoffConfig)
  },
  "serviceRadius": {
    object (Distance)
  }
}
Pola
storeCodes[]

string

Opcjonalnie: Lista kodów sklepów, które oferują dostawę lokalną. Jeśli jest puste, wartość all_stores musi być ustawiona na PRAWDA.

storeServiceType

enum (StoreServiceType)

Wskazuje, czy wszystkie sklepy lub wybrane sklepy wymienione przez tego sprzedawcę oferują dostawę lokalną.

cutoffConfig

object (CutoffConfig)

Konfiguracje związane z dostawą lokalną kończą się na koniec dnia.

serviceRadius

object (Distance)

Maksymalny promień dostawy. Jest to wymagane tylko w przypadku dostawy lokalnej.

StoreServiceType

Wskazuje, czy wszystkie czy tylko wybrane sklepy wymienione przez sprzedawcę oferują dostawę lokalną.

Wartości w polu enum
STORE_SERVICE_TYPE_UNSPECIFIED Nie określono typu usługi w sklepie.
ALL_STORES Wskazuje, czy wszystkie sklepy, obecne i przyszłe, wymienione przez tego sprzedawcę oferują dostawę lokalną.
SELECTED_STORES Informuje, że dostawa lokalna jest dostępna tylko w sklepach wymienionych w storeCodes.

CutoffConfig

Konfiguracje związane z dostawą lokalną kończą się na koniec dnia.

Zapis JSON
{
  "localCutoffTime": {
    object (LocalCutoffTime)
  },
  "storeCloseOffsetHours": string,
  "noDeliveryPostCutoff": boolean
}
Pola
localCutoffTime

object (LocalCutoffTime)

Godzina zakończenia dostawy lokalnej w danym dniu.

storeCloseOffsetHours

string (int64 format)

Dotyczy tylko lokalnej realizacji zamówień. Określa czas graniczny jako liczbę godzin przed zamknięciem sklepu. Wzajemnie wyklucza się z opcją localCutoffTime.

noDeliveryPostCutoff

boolean

Sprzedawcy mogą zrezygnować z wyświetlania dostawy lokalnej w ciągu n + 1 dni, jeśli mają skonfigurowaną usługę dostawy lokalnej w ciągu n dni. Jeśli na przykład usługa dostawy definiuje dostawę tego samego dnia i jest już po dacie granicznej, ustawienie tego pola na true spowoduje, że obliczona stawka usługi dostawy zwróci wartość NO_DELIVERY_POST_CUTOFF. W tym samym przykładzie ustawienie tego pola na false powoduje, że obliczona dostawa trwa jeden dzień. Dotyczy to tylko dostawy lokalnej.

LocalCutoffTime

Godzina zakończenia dostawy lokalnej w danym dniu.

Zapis JSON
{
  "hour": string,
  "minute": string
}
Pola
hour

string (int64 format)

Zamówienia na dostawę lokalną tego samego dnia należy złożyć do godziny, aby mogły zostać przetworzone tego samego dnia.

minute

string (int64 format)

Zamówienia na dostawę tego samego dnia muszą zostać złożone do godziny 12:00.

Odległość

Maksymalny promień dostawy. Jest to wymagane tylko w przypadku dostawy lokalnej.

Zapis JSON
{
  "value": string,
  "unit": enum (Unit)
}
Pola
value

string (int64 format)

Wartość całkowita odległości.

unit

enum (Unit)

Jednostka może się różnić w zależności od kraju. Jest ona parametryzowana tak, aby uwzględniać mile i kilometry.

Jednostka

Jednostka może się różnić w zależności od kraju. Jest ona parametryzowana tak, aby uwzględniać mile i kilometry.

Wartości w polu enum
UNIT_UNSPECIFIED Nieokreślona jednostka
MILES Jednostka miary: mile
KILOMETERS Jednostka miary: kilometry

LoyaltyProgram

Program lojalnościowy oferowany przez sprzedawcę.

Zapis JSON
{
  "loyaltyProgramTiers": [
    {
      object (LoyaltyProgramTiers)
    }
  ],
  "programLabel": string
}
Pola
loyaltyProgramTiers[]

object (LoyaltyProgramTiers)

Opcjonalnie: Poziom w programie lojalnościowym tej usługi dostawy.

programLabel

string

Etykieta programu lojalnościowego określona w ustawieniach programu lojalnościowego w Merchant Center. Ten atrybut podrzędny umożliwia Google zmapowanie Twojego programu lojalnościowego w kwalifikujących się ofertach.

LoyaltyProgramTiers

Podzbiór programu lojalnościowego sprzedawcy.

Zapis JSON
{
  "tierLabel": string
}
Pola
tierLabel

string

Atrybut podrzędny etykieta poziomu [tierLabel] różnicuje korzyści na poziomie oferty pomiędzy poszczególnymi poziomami. Ta wartość jest również określona w ustawieniach programu Merchant Center i jest wymagana do zmian w źródle danych, nawet jeśli Twój program lojalnościowy ma tylko jeden poziom.

Magazyn

magazyn realizujący zamówienia, który przechowuje i zarządza asortymentem;

Zapis JSON
{
  "name": string,
  "shippingAddress": {
    object (Address)
  },
  "cutoffTime": {
    object (WarehouseCutoffTime)
  },
  "handlingDays": string,
  "businessDayConfig": {
    object (BusinessDayConfig)
  }
}
Pola
name

string

Wymagane. Nazwa magazynu. Musi być unikalna na koncie.

shippingAddress

object (Address)

Wymagane. Adres dostawy magazynu.

cutoffTime

object (WarehouseCutoffTime)

Wymagane. Najpóźniejszą porę dnia, do której można zaakceptować zamówienie i rozpocząć jego przetwarzanie. Późniejsze zamówienia zostaną przetworzone następnego dnia. Czas jest określany na podstawie kodu pocztowego magazynu.

handlingDays

string (int64 format)

Wymagane. Liczba dni potrzebnych magazynowi na zapakowanie i wysłanie produktu. Jest to ustawiane na poziomie magazynu, ale można je zastąpić na poziomie oferty na podstawie atrybutów produktu.

businessDayConfig

object (BusinessDayConfig)

dni roboczych magazynu; Jeśli nie jest ustawione, domyślnie będzie to od poniedziałku do piątku.

Adres

Adres dostawy magazynu.

Zapis JSON
{
  "streetAddress": string,
  "city": string,
  "administrativeArea": string,
  "postalCode": string,
  "regionCode": string
}
Pola
streetAddress

string

Ulica i numer w adresie. Na przykład: 111w 31st Street.

city

string

Wymagane. Miasto, miasteczko lub gmina. Mogą również obejmować jednostki zależne lub podjednostki administracyjne (np. dzielnice lub przedmieścia).

administrativeArea

string

Wymagane. Najwyższy poziom podziału administracyjnego kraju. Może to być np. stan Kalifornia („CA”) lub prowincja Quebec („QC”).

postalCode

string

Wymagane. Kod pocztowy (np. 94043).

regionCode

string

Wymagane. Kod kraju CLDR (np. „US”).

WarehouseCutoffTime

Najpóźniejszą porę dnia, do której można zaakceptować zamówienie i rozpocząć jego przetwarzanie. Późniejsze zamówienia zostaną przetworzone następnego dnia. Czas jest określany na podstawie kodu pocztowego magazynu.

Zapis JSON
{
  "hour": integer,
  "minute": integer
}
Pola
hour

integer

Wymagane. Godzina, do której należy złożyć zamówienie, aby zostało ono zrealizowane tego samego dnia przez magazyn. Godzina jest określana na podstawie strefy czasowej magazynu.

minute

integer

Wymagane. Minuta ostatecznego terminu, do którego należy złożyć zamówienie, aby zostało ono zrealizowane tego samego dnia przez magazyn. Minuty są obliczane na podstawie strefy czasowej magazynu.

Metody

getShippingSettings

Pobranie informacji o ustawieniach dostawy.

insert

Zastąp ustawienie dostawy sprzedawcy ustawieniem dostawy w żądaniu.