- Zasób: ShippingSettings
- Usługa
- DeliveryTime
- CutoffTime
- TransitTable
- TransitTimeRow
- TransitTimeValue
- BusinessDayConfig
- Dzień powszedni
- WarehouseBasedDeliveryTime
- RateGroup
- Wartość
- Tabela
- Nagłówki
- Waga
- WeightUnit
- LocationIdSet
- Wiersz
- CarrierRate
- ShipmentType
- MinimumOrderValueTable
- StoreCodeSetWithMov
- StoreConfig
- StoreServiceType
- CutoffConfig
- LocalCutoffTime
- Dystans
- Jednostka
- LoyaltyProgram
- LoyaltyProgramTiers
- Magazyn
- Adres
- WarehouseCutoffTime
- Metody
Zasób: ShippingSettings
ustawienia dostawy na koncie sprzedawcy.
Zapis JSON |
---|
{ "name": string, "services": [ { object ( |
Pola | |
---|---|
name |
Identyfikator. Nazwa zasobu ustawienia dostawy. Format: |
services[] |
Opcjonalnie: Lista usług konta docelowego. |
warehouses[] |
Opcjonalnie: Lista magazynów, do których można się odwoływać w sekcji |
etag |
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:
|
Usługa
Usługa dostawy.
Zapis JSON |
---|
{ "deliveryCountries": [ string ], "rateGroups": [ { object ( |
Pola | |
---|---|
delivery |
Wymagane. Kod regionu CLDR krajów, w których obowiązuje usługa. |
rate |
Opcjonalnie: Definicje grup stawek dostawy. Tylko ostatnia grupa może mieć pustą wartość |
loyalty |
Opcjonalnie: Programy lojalnościowe, w przypadku których usługa dostawy jest ograniczona. |
service |
Wymagane. Wolnoformowa nazwa usługi. Musi być niepowtarzalny na koncie docelowym. |
active |
Wymagane. Wartość logiczna określająca aktywny stan usługi dostawy. |
currency |
Kod CLDR waluty, której dotyczy ta usługa. Musi być zgodna z cenami w grupach stawek. |
delivery |
Wymagane. Czas spędzony na różnych etapach od zamówienia do dostawy produktu. |
shipment |
Typy lokalizacji, do których usługa wysyła zamówienia. |
minimum |
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. |
minimum |
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. |
store |
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 ( |
Pola | |
---|---|
warehouse |
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. |
min |
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ść |
max |
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ż |
cutoff |
Definicja czasu granicznych w dniach roboczych. Jeśli nie skonfigurujesz tego ustawienia, domyślnie będzie to godzina 8:00 czasu PST. |
min |
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. |
max |
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ż |
transit |
Tabela Czas przewozu, liczba dni roboczych spędzonych w transporcie na podstawie wymiarów wiersza i kolumny. Możesz ustawić wartość |
handling |
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. |
transit |
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 |
Wymagane. Godzina, do której należy złożyć zamówienie, aby zostało ono zrealizowane tego samego dnia. |
minute |
Wymagane. Minuta ostatecznego terminu, do którego należy złożyć zamówienie, aby zostało ono zrealizowane tego samego dnia. |
time |
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 ( |
Pola | |
---|---|
postal |
Wymagane. Lista nazw regionów |
transit |
Wymagane. Lista etykiet czasu przewozu. Ostatnia wartość może wynosić |
rows[] |
Wymagane. Jeśli występuje tylko 1 zbiór wymiarów |
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 ( |
Pola | |
---|---|
values[] |
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 | |
---|---|
min |
Minimalny czas przewozu w dniach roboczych. 0 oznacza dostawę tego samego dnia, a 1 oznacza dostawę następnego dnia. |
max |
Musi być równa lub większa niż |
BusinessDayConfig
dni roboczych magazynu;
Zapis JSON |
---|
{
"businessDays": [
enum ( |
Pola | |
---|---|
business |
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 |
Wymagane. Operator, np. |
carrier |
Wymagane. Usługa operatora, np. |
warehouse |
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 ( |
Pola | |
---|---|
applicable |
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[] |
Opcjonalnie: Lista podtablic, do których odwołuje się |
carrier |
Opcjonalnie: Lista stawek operatora, do których można się odwołać za pomocą pola |
single |
Wartość grupy stawek (np. stała stawka 10 zł). Można ustawić tylko wtedy, gdy |
main |
Tabela definiująca grupę stawek, gdy |
name |
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 ( |
Pola | |
---|---|
no |
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. |
flat |
Stawka stała. Można je ustawić tylko wtedy, gdy wszystkie pozostałe pola są puste. |
price |
Odsetek ceny reprezentowany jako liczba w zapisie dziesiętnym (np. |
carrier |
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 |
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 ( |
Pola | |
---|---|
rows[] |
Wymagane. Lista wierszy, które tworzą tabelę. Musi mieć taką samą długość jak |
name |
Nazwa tabeli. Wymagane w przypadku podtabel, ignorowane w przypadku tabeli głównej. |
row |
Wymagane. Nagłówki wierszy tabeli. |
column |
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 ( |
Pola | |
---|---|
prices[] |
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 |
weights[] |
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 |
number |
Wymagane. Lista górnych granic liczby elementów. Ostatnia wartość może wynosić |
postal |
Wymagane. Lista nazw grup pocztowych. Ostatnia wartość może wynosić |
locations[] |
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 ( |
Pola | |
---|---|
unit |
Wymagane. Jednostka wagi. Akceptowane wartości to kg i lb |
amount |
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 | |
---|---|
location |
Wymagane. Niepusta lista identyfikatorów lokalizacji. Wszystkie muszą być tego samego typu (np. stan). |
Wiersz
Uwzględnij listę komórek.
Zapis JSON |
---|
{
"cells": [
{
object ( |
Pola | |
---|---|
cells[] |
Wymagane. Lista komórek, które tworzą wiersz. W przypadku tabel dwuwymiarowych musi mieć taką samą długość jak |
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 ( |
Pola | |
---|---|
name |
Wymagane. Nazwa stawki przewoźnika. Musi być unikalny w przypadku każdej grupy stawek. |
carrier |
Wymagane. Usługa operatora, np. |
carrier |
Wymagane. Usługa operatora, np. |
origin |
Wymagane. Miejsce nadania przesyłki dla tego przewoźnika. |
percentage |
Opcjonalnie: Multiplikatywny modyfikator stawki dostawy podany jako liczba w zapisie dziesiętnym. Może być ujemna. Na przykład |
flat |
Opcjonalnie: Dodatni modyfikator stawki dostawy. Może być ujemna. Na przykład |
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 ( |
Pola | |
---|---|
store |
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 ( |
Pola | |
---|---|
store |
Opcjonalnie: Lista unikalnych kodów sklepów lub pusta lista dla wszystkich sklepów. |
value |
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 ( |
Pola | |
---|---|
store |
Opcjonalnie: Lista kodów sklepów, które oferują dostawę lokalną. Jeśli jest puste, wartość |
store |
Wskazuje, czy wszystkie sklepy lub wybrane sklepy wymienione przez tego sprzedawcę oferują dostawę lokalną. |
cutoff |
Konfiguracje związane z dostawą lokalną kończą się na koniec dnia. |
service |
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 ( |
Pola | |
---|---|
local |
Godzina zakończenia dostawy lokalnej w danym dniu. |
store |
Dotyczy tylko lokalnej realizacji zamówień. Określa czas graniczny jako liczbę godzin przed zamknięciem sklepu. Wzajemnie wyklucza się z opcją |
no |
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 |
LocalCutoffTime
Godzina zakończenia dostawy lokalnej w danym dniu.
Zapis JSON |
---|
{ "hour": string, "minute": string } |
Pola | |
---|---|
hour |
Zamówienia na dostawę lokalną tego samego dnia należy złożyć do godziny, aby mogły zostać przetworzone tego samego dnia. |
minute |
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 ( |
Pola | |
---|---|
value |
Wartość całkowita odległości. |
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 ( |
Pola | |
---|---|
loyalty |
Opcjonalnie: Poziom w programie lojalnościowym tej usługi dostawy. |
program |
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 | |
---|---|
tier |
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 ( |
Pola | |
---|---|
name |
Wymagane. Nazwa magazynu. Musi być unikalna na koncie. |
shipping |
Wymagane. Adres dostawy magazynu. |
cutoff |
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. |
handling |
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. |
business |
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 | |
---|---|
street |
Ulica i numer w adresie. Na przykład: |
city |
Wymagane. Miasto, miasteczko lub gmina. Mogą również obejmować jednostki zależne lub podjednostki administracyjne (np. dzielnice lub przedmieścia). |
administrative |
Wymagane. Najwyższy poziom podziału administracyjnego kraju. Może to być np. stan Kalifornia („CA”) lub prowincja Quebec („QC”). |
postal |
Wymagane. Kod pocztowy (np. 94043). |
region |
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 |
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 |
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 |
|
---|---|
|
Pobranie informacji o ustawieniach dostawy. |
|
Zastąp ustawienie dostawy sprzedawcy ustawieniem dostawy w żądaniu. |