In dieser Anleitung werden folgende Themen behandelt:
- Allgemeine Beschreibung, wie die Verfügbarkeit für Nutzer angezeigt wird und welche Art von Daten erforderlich sind
- Spezifische Anweisungen zum Codieren der Verfügbarkeitsdaten in die
action_links in deinen Feeds - Anleitung zum Aktualisieren dieser Verfügbarkeit, wenn sie sich im Laufe des Tages ändert
- Erwartungen an die Verfügbarkeitsgenauigkeit
Neben den Verfügbarkeitsmetadaten wird erwartet, dass Sie auch Metadaten zu den Gebühren für Lieferung oder Abholung sowie Mindestbestellmengen angeben. Ein vollständiges Feedbeispiel, das die Verfügbarkeit sowie Gebühren und Mindestbestellungen zeigt, findest du unter Beispielfeed für Version 1.
Welche Verfügbarkeitsinformationen sind erforderlich?
Die Verfügbarkeit der Bestellung im Einzelhandel wird für diesen Ablauf auf Tagesebene erfasst. Diese Verfügbarkeitsdaten werden Nutzern zusammen mit Gebühren und Mindestbestellmengen mit einer Nachricht wie „Heute verfügbar“, „Verfügbar morgen“ oder „Verfügbar/TT.MM.“ angezeigt, je nach dem frühesten verfügbaren Datum.
Wenn Sie diese Daten in die Feeds einreichen, senden Sie zukünftige Datumsangaben, die verfügbar sind, sowie den letzten Zeitpunkt, zu dem ein Nutzer eine Bestellung aufgeben und deren Abholung oder Lieferung für jedes Datum planen kann. Diese beiden Informationen umfassen das Datum der Auftragsausführung und den Zeitpunkt der letzten Bestellung.
Beispiel: Wenn heute der 23. März 2021 ist und die Lieferung morgen verfügbar ist, solange der Nutzer heute um 16:00 Uhr bestellt, würden Sie folgende Daten angeben, um diese Verfügbarkeit darzustellen:
- Datum der Auftragsausführung: 24.03.2021
- Letzte Bestellung: 23.03.2021 16:00 Uhr
Da der Zeitpunkt der letzten Bestellung enthalten ist, wird das Google-Front-End nach Ablauf dieses Zeitraums automatisch auf das nächste verfügbare Datum aktualisiert.
Wenn du einen neuen Händlerfeed hochlädst, sollten jeden Tag neue Verfügbarkeitsdaten enthalten sein. Da am Front-End nur die aktuelle Verfügbarkeit angezeigt wird, müssen nur die nächsten drei bis fünf Verfügbarkeitsdaten für einen bestimmten Standort angegeben werden. Dadurch kann das Front-End die aktuelle Verfügbarkeit anzeigen und die nächste Verfügbarkeit nach Ablauf des letzten Bestellzeitpunkts anzeigen.
Verfügbarkeit über Feeds angeben
Die Verfügbarkeit von Aktionslinks ist in der action_link-Nachricht des Händlerfeeds im Feld order_online_metadata enthalten. Für jeden Händler und jede Auftragsausführungsoption befindet sich eine Liste von AvailableDay-Nachrichten im Pfad
Merchant.action_link.order_online_metadata.fulfillment_option.available_day
Diese Nachrichten sollten das folgende Format haben:
{
"fulfillment_date": {
"year": "2020",
"month": "10",
"day": "1"
},
"last_ordering_time": {
"seconds": "1601614800" // 2020/10/1, 10pm
}
}
In diesem Format steht fulfillment_date für das Jahr, den Monat und den Tag, an dem Verfügbarkeit verfügbar ist. Dieses Datum muss sich auf den vom Händler angegebenen Standort beziehen.
last_ordering_time ist ein Unix-Zeitstempel in Sekunden. Sie ist unabhängig von der Zeitzone und markiert den letzten Moment, an dem der Händler Bestellungen für das in fulfillment_date angegebene Datum annehmen kann. Der Zeitpunkt der letzten Bestellung kann jederzeit vor oder während des Auftragsausführungsdatums liegen. Sobald der Zeitpunkt der letzten Bestellung verstrichen ist, zeigt Google die Verfügbarkeit für das entsprechende Auftragsausführungsdatum automatisch an. Die Verfügbarkeit wird ab dem nächsten verfügbaren Auftragsausführungsdatum angezeigt.
Die Referenzdefinition von order_online_metadata findest du in der Händlerfeed-Referenz. Ein Feedbeispiel, das die Verfügbarkeit im JSON-Format enthält, findest du unter Feedbeispiele für Bestellungen und Metadaten im Einzelhandel.
Verfügbarkeit in Echtzeit aktualisieren
Wenn sich die Verfügbarkeit eines Standorts für die Lieferung oder Abholung zwischen den Zeiten des Sendens eines täglichen Feeds ändert, kann die REST API für Echtzeitaktualisierungen verwendet werden, um die Verfügbarkeit zu aktualisieren, die Nutzern angezeigt wird.
Aktualisierungen werden jeweils nur für einen Händler vorgenommen. Beim Aktualisieren geben Sie den Händler sowie die Felder an, die im Rahmen des API-Endpunkts aktualisiert werden sollen. Anschließend fügen Sie im Text der Anfrage die neuen Daten für diese Felder ein. Alle Felder, die aktualisiert werden, werden durch die angegebenen Informationen ersetzt.
Zum Aktualisieren der Verfügbarkeit senden Sie eine Patchanfrage an den folgenden Endpunkt:
PATCH https://mapsbooking.googleapis.com/v1alpha/inventory/partners/{partnerId}/merchants/{merchantId}?updateMask=action_link
Der Text der Anfrage wäre dann ein Merchant-Objekt, das nur die action_link enthält (da wir die updateMask so festgelegt haben, dass nur action_link enthalten ist):
{
"action_link": [
..., // all required action_link fields here
"order_online_metadata": {
"fulfillment_option": [
"fulfillment_type": "FULFILLMENT_TYPE_DELIVERY",
"available_day": [ // Include the updated availability here
{
"fulfillment_date": {
"year": "2020",
"month": "10",
"day": "1"
}
"last_ordering_time": {
"seconds": "1601614800" // 2020/10/1, 10pm
}
},
... // Other updated availability_days
]
]
}
]
}
Wenn die API-Anfrage erfolgreich ist, enthält die Antwort das Händlerobjekt mit den neu aktualisierten Daten.
Eine vollständige Referenzspezifikation für die Aktualisierungsmethode für Händler finden Sie unter Methode: Inventory.partners.merchants.patch.
Verfügbarkeitsgenauigkeit
Bei der Funktion „Mit Google reservieren“ kann es vorkommen, dass sich die Verfügbarkeit von Produkten aufgrund verschiedener Faktoren ändert. Diese Faktoren umfassen:
- Änderungen an der Verfügbarkeit basierend auf der Bestellgröße
- Änderungen an der Verfügbarkeit basierend auf der Zeit zum Abschließen der Bestellung und zum Bezahlvorgang
- Latenz zwischen dem Aktualisieren von Verfügbarkeitsänderungen entweder über Feeds oder durch Echtzeitaktualisierungen
Jeder dieser Faktoren kann dazu führen, dass die für den Nutzer angezeigte Verfügbarkeit nicht die endgültige Verfügbarkeit ist, die dem Nutzer an der Kasse angezeigt wird. Das Ziel der Implementierung der Verfügbarkeit besteht nicht darin, sie vollständig zu eliminieren, sondern Nutzern so oft wie möglich verständliche Informationen zur Verfügung zu stellen.
Partner sollten eine Implementierung anbieten, die Nutzern möglichst genaue Informationen zur bestmöglichen Verfügbarkeit liefert. Wenn sich die Verfügbarkeit aufgrund von Bestelldetails ändert, sollte dies den Nutzern deutlich angezeigt werden. Wenn du dir nicht sicher bist, was in deinem Fall erforderlich ist, wende dich an deinen „Mit Google reservieren“-Ansprechpartner.