Die Merchant API v1beta wurde am 28. Februar 2026 eingestellt. Eine Anleitung zur Umstellung auf die aktuelle stabile Version finden Sie unter Von v1beta zu v1 migrieren.

Online-Rückgabebedingungen erstellen und verwalten

Auf dieser Seite erfahren Sie, wie Sie Ihre Online-Rückgabebedingungen aufrufen.

Die Merchant API unterstützt die folgenden Methoden zum Abrufen von Online-Rückgabebedingungen:

Achten Sie darauf, dass Ihre Rückgabebedingungen für alle Besucher Ihrer Website auffindbar und zugänglich sind, ohne dass sie sich anmelden, registrieren oder personenbezogene Daten eingeben müssen. Außerdem müssen die Rückgabebedingungen im Merchant Center und auf Ihrer Website einheitlich sein.

Vorhandene Online-Rückgabebedingungen abrufen

Verwenden Sie die accounts.onlineReturnPolicies.get Methode, um vorhandene Online-Rückgabebedingungen abzurufen.

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/onlineReturnPolicies/{ONLINE_RETURN_POLICY_ID}

Wenn die Anfrage erfolgreich ist, enthält die Antwort die OnlineReturnPolicy Ressource, wie im folgenden Beispiel gezeigt:

{
  "onlineReturnPolicies": [
    {
      "returnPolicyId": "ONLINE_RETURN_POLICY_ID",
      "label": "default",
      "countries": [
        "COUNTRY_CODE"
      ],
      "policy": {
        "type": "NO_RETURNS"
      },
      "restockingFee": {
        "fixedFee": {
          "amountMicros": "0",
          "currencyCode": "USD"
        }
      },
      "returnPolicyUri": "RETURN_POLICY_URI"
    }
  ]
}

Der Wert NO_RETURNS gibt an, dass Rückgaben für das angegebene Land nicht unterstützt werden.

Das Feld restockingFee im Antworttextkörper steht für die Gebühr für die Wiederauffüllung des Lagers, die entweder eine Pauschalgebühr oder ein Prozentsatz des Artikelpreises in Mikros sein kann.

Alle Online-Rückgabebedingungen auflisten

Verwenden Sie die accounts.onlineReturnPolicies.list Methode, um alle Online-Rückgabebedingungen aufzulisten, wie in der folgenden Anfrage gezeigt:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/onlineReturnPolicies

Wenn die Anfrage erfolgreich ist, enthält die Antwort alle vorhandenen Online-Rückgabebedingungen für das Konto, wie in der folgenden Beispielantwort gezeigt:

{
  "onlineReturnPolicies": [
    {
      "returnPolicyId": "7216992546",
      "label": "default",
      "countries": [
        "IN"
      ],
      "policy": {
        "type": "NO_RETURNS"
      },
      "restockingFee": {
        "fixedFee": {
          "amountMicros": "0",
          "currencyCode": "USD"
        }
      },
      "returnPolicyUri": "http://example-pet-store.com/return"
    },
    {
      "returnPolicyId": "7274318400",
      "label": "default",
      "countries": [
        "GB"
      ],
      "policy": {
        "type": "NUMBER_OF_DAYS_AFTER_DELIVERY",
        "days": "15"
      },
      "restockingFee": {
        "fixedFee": {
          "amountMicros": "10000000",
          "currencyCode": "GBP"
        }
      },
      "returnMethods": [
        "AT_A_KIOSK"
      ],
      "itemConditions": [
        "NEW"
      ],
      "returnShippingFee": {
        "type": "FIXED",
        "fixedFee": {
          "amountMicros": "0",
          "currencyCode": "GBP"
        }
      },
      "returnPolicyUri": "http://example-pet-store.com/return-new",
      "processRefundDays": 7,
      "acceptExchange": true
    }
  ]
}

Im Antworttextkörper steht das Feld returnPolicyId für die eindeutige Kennung der Online-Rückgabebedingungen.

Das Feld returnMethods gibt die Methoden an, die für die Rückgabe von Artikeln zulässig sind. AT_A_KIOSK bedeutet, dass der Artikel an einem Kiosk zurückgegeben werden kann. Die anderen möglichen Werte sind IN_STORE und BY_MAIL.

Das Feld processRefundDays gibt die Anzahl der Tage an, die der Verkäufer für die Bearbeitung von Erstattungen benötigt.