Migracja zarządzania zasadami zwrotów online

Zmieniliśmy zasób Content API OnlineReturnPolicy i powiązane z nim pola, w tym ReturnPolicyPolicy i ReturnPolicySeasonalOverride.

Odpowiednikiem zasobu returnpolicy w interfejsie Merchant API w interfejsie Content API jest zasób accounts.onlineReturnPolicies.

Z tej tabeli dowiesz się, co się zmienia w przypadku OnlineReturnPolicy.

Content API. Merchant API
"country": string "countries": [ string ]
"policy": { object (ReturnPolicyPolicy) } "policy": { object (Policy) }
"seasonalOverrides": [ { object (ReturnPolicySeasonalOverride) } ] "seasonalOverrides": [ { object (SeasonalOverride) } ],
nonFreeReturnReasons": [ string ] To pole zostanie wycofane.
kind To pole zostanie wycofane.
"returnShippingFee": { object (Price) } "returnShippingFee": { object (ReturnShippingFee) }

Oprócz tego w Merchant API jest kilka nowych pól.

Pole Merchant API Opis
"restockingFee": { object (RestockingFee) }, Opcjonalnie. Opłata za uzupełnienie towarów, która obowiązuje w przypadku wszystkich kategorii przyczyn zwrotu. Jeśli wartość nie jest ustawiona, będzie to traktowane jako bezpłatna opłata za uzupełnienie zapasów.
"returnMethods": [ enum (ReturnMethod) ] Opcjonalnie. Metody zwrotu, za pomocą których klienci mogą zwrócić produkt. Ta wartość nie może być pusta, chyba że typ zasad zwrotów to noReturns.
"itemConditions": [ enum (ItemCondition) ], Opcjonalnie. Warunki produktu akceptowane w przypadku zwrotów nie mogą być puste, chyba że typ zasad zwrotów to noReturns.
"returnShippingFee": { object (ReturnShippingFee) } Opcjonalnie. Opłata za przesyłkę zwrotną. Należy ustawić tylko wtedy, gdy klient musi pobrać i wydrukować etykietę zwrotu.
"returnPolicyUri": string Wymagane. Identyfikator URI zasad zwrotów. Google używa tych informacji do weryfikacji zasad. Musi to być prawidłowy adres URL.
"acceptDefectiveOnly": boolean Wymagane. Określa, że sprzedawca przyjmuje zwroty tylko w przypadku wadliwych produktów.
"processRefundDays": integer Opcjonalnie. Określa liczbę dni, w ciągu których sprzedawcy przetwarzają zwroty środków.
"acceptExchange": boolean Opcjonalnie. Określa, czy sprzedawca umożliwia klientom wymianę produktów.
"returnLabelSource": enum (ReturnLabelSource) Określa źródło etykiety zwrotnej. Wymagany, gdy metoda zwrotu to BY_MAIL.

ReturnPolicyPolicy

Content API ReturnPolicyPolicy staje się Policy w Merchant API. Oto jak zmieniły się pola.

Content API. Merchant API
"type": string, "type": enum (Type)
Możliwe wartości: NUMBER_OF_DAYS_AFTER_DELIVERY, NO_RETURNS or LIFETIME_RETURNS.
"numberOfDays": string "days": string
"lastReturnDate": string Zamiast niej używaj zasady days. Jest to liczba dni, w których można zwrócić produkty po dostawie. Jeden dzień to 24 godziny od momentu dostawy. Wymagane w przypadku zwrotów NUMBER_OF_DAYS_AFTER_DELIVERY.

ReturnPolicySeasonalOverride

Interfejs Content API ReturnPolicySeasonalOverride staje się interfejsem SeasonalOverride w Merchant API. Oprócz zmian w polach dodatkowe polereturn_window jest sumą, która może być równa returnDays lub returnUntilDate:

  "returnDays": integer,
  "returnUntilDate": {
    object (Date)

Oznaczają one:

  • returnDays: liczba dni (od daty dostawy), w ciągu których można jeszcze zwrócić produkt.
  • returnUntilDate: stała data zakończenia, do której produkt może zostać zwrócony.

Oto jak zmieniły się pola.

Content API. Merchant API
"name": string "label": string
"startDate": string "startDate": { object (Date) }
"endDate": string "endDate": { object (Date) }
"policy": { object (ReturnPolicyPolicy) } Zamiast niej używaj zasady policy.

Definicje innych obiektów

Definicje nowych obiektów Merchant API

  • RestockingFee
  • ReturnMethod
  • ItemCondition
  • ReturnShippingFee
  • Type
  • ReturnLabelSource

zobacz accounts.onlineReturnPolicies.

Metody

W przypadku Merchant API wprowadziliśmy też pewne zmiany w metodach Content API.

Content API. Merchant API
customBatch W przypadku interfejsu Merchant API stosujemy inne podejście. Zobacz Refaktoryzacja kodu pod kątem żądań równoczesnych.
delete delete
get get
insert create
list list