Die Content API-Ressource OnlineReturnPolicy und die zugehörigen Felder, einschließlich ReturnPolicyPolicy und ReturnPolicySeasonalOverride, haben sich geändert.
Das Merchant API-Äquivalent der Ressource returnpolicy in der Content API ist accounts.onlineReturnPolicies.
In dieser Tabelle wird erläutert, was sich in OnlineReturnPolicy ändert.
| Content API | Merchant API |
|---|---|
"country": string
|
"countries": [ string ]
|
"policy": {
object (ReturnPolicyPolicy)
}
|
"policy": {
object (Policy)
}
|
"seasonalOverrides": [
{
object (ReturnPolicySeasonalOverride)
}
]
|
"seasonalOverrides": [
{
object (SeasonalOverride)
}
],
|
nonFreeReturnReasons": [ string ]
|
Dieses Feld wird entfernt.
|
kind
|
Dieses Feld wird entfernt.
|
"returnShippingFee": {
object (Price)
}
|
"returnShippingFee": {
object (ReturnShippingFee)
}
|
Außerdem gibt es in der Merchant API eine Reihe neuer Felder.
| Merchant API-Feld | Beschreibung |
|---|---|
"restockingFee": {
object (RestockingFee)
},
|
Optional. Die Rücknahmegebühr, die für alle Kategorien von Rücksendegründen gilt.
Wenn der Wert nicht festgelegt ist, wird dies als kostenlose Gebühr für die Wiederauffüllung des Lagerbestands behandelt.
|
"returnMethods": [
enum (ReturnMethod)
]
|
Optional. Die Rückgabemethoden, mit denen Kunden einen Artikel zurückgeben können. Dieser Wert darf nicht leer sein, es sei denn, der Typ der Rückgaberichtlinie ist „noReturns“.
|
"itemConditions": [ enum (ItemCondition) ],
|
Optional. Die für Rückgaben akzeptierten Artikelzustände dürfen nicht leer sein, es sei denn, der Typ der Rückgabebedingungen ist noReturns..
|
"returnShippingFee": {
object (ReturnShippingFee)
}
|
Optional. Die Rücksendegebühr. Sollte nur festgelegt werden, wenn der Kunde das Rücksendelabel herunterladen und ausdrucken muss.
|
"returnPolicyUri": string
|
Erforderlich. Die URI der Rückgabebedingungen. Google verwendet sie, um die Richtlinie zu validieren.
Es muss eine gültige URL sein.
|
"acceptDefectiveOnly": boolean
|
Erforderlich. Gibt an, dass ein Händler nur mangelhafte Produkte für Retouren akzeptiert.
|
"processRefundDays": integer
|
Optional. Gibt die Anzahl der Tage an, die Händler für die Bearbeitung von Erstattungen benötigen.
|
"acceptExchange": boolean
|
Optional. Gibt an, ob der Händler Kunden den Umtausch von Produkten erlaubt. |
"returnLabelSource": enum (ReturnLabelSource)
|
Gibt die Quelle des Rücksendelabels an. Erforderlich, wenn die Rückgabemethode BY_MAIL ist.
|
ReturnPolicyPolicy
Die Content API ReturnPolicyPolicy wird in der Merchant API zu Policy. So haben sich die Felder geändert.
| Content API | Merchant API |
|---|---|
"type": string,
|
"type": enum (Type)
Zulässige Werte:
NUMBER_OF_DAYS_AFTER_DELIVERY, NO_RETURNS or LIFETIME_RETURNS.
|
"numberOfDays": string
|
"days": string
|
"lastReturnDate": string
|
Verwenden Sie stattdessen days. Sie gibt die Anzahl der Tage an, innerhalb derer Artikel nach der Lieferung zurückgegeben werden können. Ein Tag entspricht dabei 24 Stunden nach dem Zeitstempel der Lieferung. Erforderlich für NUMBER_OF_DAYS_AFTER_DELIVERY-Rückgaben.
|
ReturnPolicySeasonalOverride
Die Content API ReturnPolicySeasonalOverride wird in der Merchant API zu SeasonalOverride. Zusätzlich zu den Änderungen an Feldern ist das zusätzliche Feld return_window eine Vereinigung, die entweder returnDays oder returnUntilDate sein kann:
"returnDays": integer,
"returnUntilDate": {
object (Date)
Sie haben die folgenden Bedeutungen:
returnDays: Anzahl der Tage (ab dem Lieferdatum), innerhalb derer das Produkt noch zurückgegeben werden kann.returnUntilDate: Festes Enddatum, bis zu dem das Produkt zurückgegeben werden kann.
So haben sich die Felder geändert.
| Content API | Merchant API |
|---|---|
"name": string
|
"label": string
|
"startDate": string
|
"startDate": {
object (Date)
}
|
"endDate": string
|
"endDate": {
object (Date)
}
|
"policy": {
object (ReturnPolicyPolicy)
}
|
Verwenden Sie stattdessen policy.
|
Definitionen anderer Objekte
Definitionen der neuen Merchant API-Objekte
RestockingFeeReturnMethodItemConditionReturnShippingFeeTypeReturnLabelSource
Weitere Informationen finden Sie unter accounts.onlineReturnPolicies.
Methoden
Bei der Merchant API gibt es auch einige Änderungen gegenüber den Methoden der Content API.
| Content API | Merchant API |
|---|---|
customBatch
|
Bei der Merchant API wird ein anderer Ansatz verfolgt. Weitere Informationen finden Sie unter Code für gleichzeitige Anfragen umgestalten. |
delete
|
delete
|
get
|
get
|
insert
|
create
|
list
|
list
|