Anfragestruktur
BatchAvailabilityLookup-Anfragen können sich über mehrere Dienste für denselben Händler erstrecken und angeforderte Zeitblöcke können sich über mehrere Ressourcen und Tage erstrecken. Wir empfehlen, für alle Händler eine einzige Dienstleistungs-ID zu verwenden, um die Integration zu vereinfachen.
Antwortzeiten
BatchAvailabilityLookup-Anfragen haben einen Latenzschwellenwert von 1,5 Sekunden, bevor die Antwort als Fehler betrachtet wird. Achten Sie darauf, dass Ihr internes Netzwerk und das DNS-Routing synchronisiert sind, um Verzögerungen bei der Anfrage, die Ihre Infrastruktur erreicht, zu minimieren. Wenn es erhebliche Zeitüberschreitungsfehler gibt, wird Ihre Integration möglicherweise offline genommen, bis Sie die Probleme beheben können.
Jede Antwort auf eine Anfrage muss den tatsächlichen Status Ihres Inventars zu diesem Zeitpunkt zurückgeben und nicht den Status, als der Buchungsvorgang aufgerufen wurde. Wenn ein Zeitfenster ausgebucht ist, geben Sie das in Ihren Antworten an.
Definitionen
Mit der Methode BatchAvailabilityLookup wird überprüft, ob Nutzern während des Reservierungsprozesses nur aktuelle Slots präsentiert werden.
BatchAvailabilityLookup-Anfrage
message BatchAvailabilityLookupRequest {
// ID of the merchant.
string merchant_id = 1;
// Multiple slot times to be checked for availability. All queried times apply
// to the same merchant_id and service_id.
repeated SlotTime slot_time = 3;
reserved 2;
}
BatchAvailabilityLookup-Antwort
// Response for the [ext.maps.booking.partner.v3.BatchAvailabilityLookupRequest]
// RPC with the availabilities of the appointment slots.
message BatchAvailabilityLookupResponse {
// The availabilities for the requested SlotTime entries. There must be
// exactly one slot_time_availability for each SlotTime entry in the
// [ext.maps.booking.partner.v3.BatchAvailabilityLookupRequest].
repeated SlotTimeAvailability slot_time_availability = 1;
}
SlotTime
// Identifies a Slot service_id and start time and optionally, the Slot duration
// and resources, for a specific merchant. Note that this differs from the
// definition of Slot, as it does not include merchant_id identifier.
message SlotTime {
// ID of the service. (required)
string service_id = 5;
// Start time of the appointment slot in seconds of UTC time since Unix epoch
// (required)
int64 start_sec = 1;
// Duration of the appointment slot in seconds (optional)
int64 duration_sec = 2;
// Opaque tag that identifies the availability slot and matches the value
// provided in the Availability Feed (optional)
string availability_tag = 3;
// The set of resources that specifies the appointment slot, e.g. by
// indicating the staff member and room selected by the user, or party size
// for dining slots (optional)
ResourceIds resource_ids = 4;
// Indicates whether bookings of this slot will be confirmed
// synchronously or asynchronously. (optional)
// An UNSPECIFIED value will be interpreted as synchronous.
ConfirmationMode confirmation_mode = 6;
}
SlotTimeAvailability
Wenn keine Slots gefunden werden, gib eine leere Antwort zurück. Geben Sie keinen 400-Fehler zurück, sondern stattdessen 204 oder einen anderen 2xx-Code. Damit wird überprüft, ob die Antwort korrekt empfangen wurde.
message SlotTimeAvailability {
// The SlotTime for which availability was checked.
SlotTime slot_time = 1;
// Whether the requested SlotTime is available
bool available = 2;
}
BatchAvailabilityLookup-Beispiele
Seitenaufbau
Wenn ein Nutzer auf Online buchen klickt, um den Buchungsvorgang zu starten, wird eine BatchAvailabilityLookup-Anfrage mit bekannten verfügbaren Zeiträumen für den Händler gesendet. Für jeden im Request gesendeten Slot gibt Ihr Buchungsserver eine Antwort mit der tatsächlichen, aktuellen Verfügbarkeit des Slots zurück. Im Frontend werden dem Nutzer nur verfügbare Zeiträume angezeigt.
Wenn ein Nutzer die Anzahl der Personen ändert oder ein anderes Datum auswählt, kann eine weitere Seitenladeanfrage gesendet werden.
Anfrage zum Laden der Seite
{
"merchant_id" : "1234",
"slot_time" : [
{
"duration_sec" : "1800",
"resource_ids" : {
"party_size" : 2
},
"service_id" : "1000",
"start_sec" : "1606467600"
},
{
"duration_sec" : "1800",
"resource_ids" : {
"party_size" : 2
},
"service_id" : "1000",
"start_sec" : "1606469400"
},
{
"duration_sec" : "1800",
"resource_ids" : {
"party_size" : 2
},
"service_id" : "1000",
"start_sec" : "1606471200"
}
]
}
Reaktion auf Seitenaufbau
{ "slot_time_availability" :
[
{
"available" : true,
"slot_time" : {
"duration_sec" : "1800",
"resource_ids" : {
"party_size" : 2 },
"service_id" : "1000",
"start_sec" : "1606467600" }
},
{
"available" : true,
"slot_time" : {
"duration_sec" : "1800",
"resource_ids" : {
"party_size" : 2 },
"service_id" : "1000",
"start_sec" : "1606469400" }
},
{
"available" : false,
"slot_time" : {
"duration_sec" : "1800",
"resource_ids" : {
"party_size" : 2 },
"service_id" : "1000",
"start_sec" : "1606471200" }
}
]
}
Slot-Klick
Wenn ein Nutzer einen buchbaren Termin auswählt, wird eine BatchAvailabilityLookup-Anfrage für den jeweiligen Termin gesendet. Ihr Buchungsserver gibt eine Antwort mit der tatsächlichen, aktuellen Verfügbarkeit des Zeitfensters zurück. Die erwartete Antwort für die Verfügbarkeit ist False, wenn der Termin von einem anderen Google-Nutzer, intern in Ihrem System oder zwischen dem Laden der Seite und den Anfragen zum Klicken auf den Termin gebucht wurde.
Anfrage für Slot-Klick
{
"merchant_id" : "1234",
"slot_time" : [
{
"duration_sec" : "1800",
"resource_ids" : {
"party_size" : 2
},
"service_id" : "1000",
"start_sec" : "1606467600"
}
]
}
Antwort auf Slot-Klick
{
"slot_time_availability" : [
{
"available" : true,
"slot_time" : {
"duration_sec" : "1800",
"resource_ids" : {
"party_size" : 2
},
"service_id" : "1000",
"start_sec" : "1606467600"
}
}
]
}