Verwaltung der Online-Rückgabebedingungen migrieren
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Die Content API-Ressource OnlineReturnPolicy und die zugehörigen Felder, einschließlich ReturnPolicyPolicy und ReturnPolicySeasonalOverride, haben sich geändert.
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..
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:
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-08 (UTC)."],[],[],null,["# Migrate online return policy management\n\nThe Content API resource `OnlineReturnPolicy` and associated fields including\n`ReturnPolicyPolicy` and `ReturnPolicySeasonalOverride` have changed.\n\nThe Merchant API equivalent of the\n[`returnpolicy`](/shopping-content/reference/rest/v2.1/returnpolicy) resource in\nContent API is\n[`accounts.onlineReturnPolicies`](/merchant/api/reference/rest/accounts_v1/accounts.onlineReturnPolicies).\n\nThis table explains what changes in `OnlineReturnPolicy`.\n\n| Content API | Merchant API |\n|------------------------------------------------------------------------|-------------------------------------------------------------|\n| ` \"country\": string ` | ` \"countries\": [ string ] ` |\n| ` \"policy\": { object (ReturnPolicyPolicy) } ` | ` \"policy\": { object (Policy) } ` |\n| ` \"seasonalOverrides\": [ { object (ReturnPolicySeasonalOverride) } ] ` | ` \"seasonalOverrides\": [ { object (SeasonalOverride) } ], ` |\n| ` nonFreeReturnReasons\": [ string ] ` | This field goes away.` ` |\n| `kind ` | This field goes away.` ` |\n| ` \"returnShippingFee\": { object (Price) } ` | ` \"returnShippingFee\": { object (ReturnShippingFee) } ` |\n\nIn addition, a number of fields are new with Merchant API.\n\n| Merchant API field | Description |\n|---------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` \"restockingFee\": { object (RestockingFee) }, ` | Optional. The restocking fee that applies to all return reason categories. This would be treated as a free restocking fee if the value is not set. ` ` |\n| ` \"returnMethods\": [ enum (ReturnMethod) ] ` | Optional. The return methods of how customers can return an item. This value is required to not be empty unless the type of return policy is noReturns. ` ` |\n| ` \"itemConditions\": [ enum (ItemCondition) ], ` | Optional. The item conditions accepted for returns must not be empty unless the type of return policy is `noReturns.` |\n| ` \"returnShippingFee\": { object (ReturnShippingFee) } ` | Optional. The return shipping fee. Should be set only when customer need to download and print the return label. ` ` |\n| ` \"returnPolicyUri\": string ` | Required. The return policy URI. Google uses this to validate the policy. It must be a valid URL. ` ` |\n| ` \"acceptDefectiveOnly\": boolean ` | Required. Specifies that a merchant accepts only defective products for returns. ` ` |\n| ` \"processRefundDays\": integer ` | Optional. Specifies the number of days it takes for merchants to process refunds. ` ` |\n| ` \"acceptExchange\": boolean ` | Optional. Specifies whether the merchant allows customers to exchange products. |\n| ` \"returnLabelSource\": enum (ReturnLabelSource) ` | Specifies the return label source. Required when return method is BY_MAIL. ` ` |\n\nReturnPolicyPolicy\n------------------\n\nThe Content API `ReturnPolicyPolicy` becomes `Policy` in Merchant API. Here's\nhow the fields have changed.\n\n| Content API | Merchant API |\n|------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` \"type\": string, ` | ` \"type\": enum (Type) ` Possible values include ` NUMBER_OF_DAYS_AFTER_DELIVERY, NO_RETURNS or LIFETIME_RETURNS. ` |\n| ` \"numberOfDays\": string ` | ` \"days\": string ` |\n| ` \"lastReturnDate\": string ` | Use `days` instead. It represents the number of days items can be returned after delivery, where one day is defined as 24 hours after the delivery timestamp. Required for `NUMBER_OF_DAYS_AFTER_DELIVERY` returns. |\n\nReturnPolicySeasonalOverride\n----------------------------\n\nThe Content API `ReturnPolicySeasonalOverride` becomes `SeasonalOverride` in\nMerchant API. In addition to the changes in fields, the additional field\n`return_window` is a union that can be either `returnDays` or `returnUntilDate`: \n\n \"returnDays\": integer,\n \"returnUntilDate\": {\n object (Date)\n\nThey have the following meanings:\n\n- `returnDays`: Number of days (from the delivery date) that the product can still be returned.\n- `returnUntilDate`: Fixed end date until which the product can be returned.\n\nHere's how the fields have changed.\n\n| Content API | Merchant API |\n|-----------------------------------------------|------------------------------------|\n| ` \"name\": string ` | ` \"label\": string ` |\n| ` \"startDate\": string ` | ` \"startDate\": { object (Date) } ` |\n| ` \"endDate\": string ` | ` \"endDate\": { object (Date) } ` |\n| ` \"policy\": { object (ReturnPolicyPolicy) } ` | Use `policy` instead. |\n\nDefinitions of other objects\n----------------------------\n\nFor definitions of the new Merchant API objects\n\n- `RestockingFee`\n- `ReturnMethod`\n- `ItemCondition`\n- `ReturnShippingFee`\n- `Type`\n- `ReturnLabelSource`\n\nsee\n[`accounts.onlineReturnPolicies`](/merchant/api/reference/rest/accounts_v1/accounts.onlineReturnPolicies).\n\nMethods\n-------\n\nWith Merchant API, there are some changes from the Content API methods as well.\n\n| Content API | Merchant API |\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` customBatch ` | With Mechant API, there is a different approach. See [Refactor code for concurrent requests.](/merchant/api/guides/compatibility/refactor-concurrent-requests) |\n| ` delete ` | ` delete ` |\n| ` get ` | ` get ` |\n| ` insert ` | `create` |\n| ` list ` | ` list ` |"]]
