Lieferdauer für Produkte festlegen

Die Produktlieferdauer ist eine Schätzung der Zeit, die nach Aufgabe einer Bestellung benötigt wird. Partner für Versandsignale können diese Funktion nutzen, um im Namen der Händler, mit denen sie zusammenarbeiten, Lieferzeiten für bestimmte Regionen festzulegen.

Partner für Versandsignale können diese Ressource verwenden, um die Lieferdauer für Paare aus Angebot und Region festzulegen und vorhandene Lieferzeiten im Namen der mit ihnen verknüpften Händler anzusehen oder zu löschen. Eine ProductDeliveryTime-Ressource speichert mehrere Lieferzeiten und es kann nur eine ProductDeliveryTime-Instanz pro Angebot geben.

Wenn Sie die Ressource ProductDeliveryTime verwenden möchten, müssen Sie sich mit Ihrem eigenen Merchant Center-Konto authentifizieren und nicht mit dem Händlerkonto, das Sie aktualisieren.

Entwicklung

Partner für Versandsignale können die Lieferdauer eines Produkts erstellen oder aktualisieren, indem sie create mit merchantId des zu aktualisierenden Händlerkontos und einer ProductDeliveryTime-Instanz aufrufen. Wenn du eine vorhandene Lieferdauer für ein Produkt aktualisieren möchtest, musst du alle ProductDeliveryTime-Felder angeben, auch die, die nicht geändert wurden. Jede create-Anfrage überschreibt die vorherige Instanz, sodass nicht angegebene Felder verloren gehen. Diese Methode gibt die Instanz ProductDeliveryTime mit den aktualisierten Informationen zurück, die Sie einreichen.

Jede ProductDeliveryTime kann maximal 100 areaDeliveryTimes-Einträge enthalten.

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime

Hier ein Beispiel für den Anfragetext:

{
  "productId": {
    "productId": "online:en:US:offer-id"
  }
  "areaDeliveryTimes": [
    {
      "deliveryArea": {
        "countryCode": "US"
        "postalCodeRange": {
          "firstPostalCode": "123*"
          "lastPostalCode": "456*"
        }
      }
      "deliveryTime": {
        "minHandlingTimeDays": "0"
        "maxHandlingTimeDays": "1"
        "minTransitTimeDays": "2"
        "maxTransitTimeDays": "4"
      }
    },
    {
      "deliveryArea": {
        "countryCode": "US"
        "administrativeAreaCode": "NY"
      }
      "deliveryTime": {
        "minHandlingTimeDays": "0"
        "maxHandlingTimeDays": "1"
        "minTransitTimeDays": "5"
        "maxTransitTimeDays": "7"
      }
    }
  ]
}

get

Wenn du die Lieferdauer eines Produkts abrufen möchtest, rufe get mit der merchantId des Händlers und dem productId auf. Diese Methode gibt die ProductDeliveryTime-Instanz für die angegebene productId zurück.

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime/productId

delete

Partner für Versandsignale können die Lieferdauer eines Produkts löschen, indem sie delete mit der merchantId des Händlers und dem productId aufrufen. Diese Methode gibt eine leere Antwort zurück.

DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime/productId