Eşzamanlı rezervasyonlar, gerçek zamanlı olarak onaylanan veya reddedilen rezervasyonlar olarak tanımlanır.
Eşzamansız rezervasyonlar, satıcının daha sonra onayladığı veya reddettiği rezervasyonlar olarak tanımlanır.
Rezervasyonlar, kullanılabilirlik düzeyinde eşzamanlı veya eşzamansız olarak belirtilir. Bu aynı zamanda, belirli bir satıcı ve hizmet için hem eşzamanlı hem de eşzamansız kullanılabilirlik slotları olabileceği anlamına gelir.
Uygun uygulamayı belirlemek için önce envanterinizin hangi kategoriye girdiğini belirleyin:
- Yalnızca eşzamanlı rezervasyonları etkinleştirme: Tüm satıcılar ve hizmetler anında onaylanır.
- Eşzamansız rezervasyonları etkinleştirme: Satıcıların ve hizmetlerin bazıları veya tümü, satıcılardan manuel olarak onay almayı gerektirir.
eşzamansız rezervasyon ölçütleri
- Actions Center'da eşzamansız rezervasyonların değiştirilmesi desteklenmez.
- Satıcılar, iş ortağının online sistemi (ör. restoranın barındırma paneli) üzerinden rezervasyonu kabul edebilmeli veya reddedebilmelidir. Satıcının rezervasyon kabul edip etmediğini belirlemek için kullanıcı adına satıcıyı aramasına izin verilmez.
- Yeni bir rezervasyon zamanıyla ilgili satıcı teklifi desteklenmez. Rezervasyon isteği orijinal haliyle kabul edilmeli veya reddedilmelidir.
Yalnızca eşzamanlı rezervasyonlar etkinleştiriliyor
Standart uygulamada varsayılan olarak eşzamanlı rezervasyonlar kullanılır. Daha fazla bilgi için lütfen Rezervasyonlar Uçtan Uca entegrasyon belgelerine bakın.
Eşzamansız rezervasyonu etkinleştirme
Satıcıların bazıları veya tümü eşzamansız rezervasyon akışı kullanıyorsa aşağıdaki değişikliklerin yapılması gerekir:
-
Onay modu: Müsaitlik durumu slotlarının tüm temsillerinde artık, söz konusu müsaitlik durumu slotunun rezervasyonlarının nasıl onaylandığını açıklayan bir
confirmation_mode
alanı bulunmaktadır. Aşağıdakiler için her kullanılabilirlik slotununconfirmation_mode
değerini belirtin:- Müsaitlik Durumu Feed'inde,
confirmation_mode
, kullanılabilirlik düzeyinde belirtilmektedir - Reservation Server API yöntemlerinde
confirmation_mode
, alan düzeyinde belirtilir - Real-Time Updates API yöntemlerinde
confirmation_mode
, kullanılabilirlik düzeyinde belirtiliyor
- Müsaitlik Durumu Feed'inde,
- Rezervasyon durumu: Tüm rezervasyon temsilleri, rezervasyonun durumunu temsil eden bir
status
alanı içerir. Üç yeni eşzamansız durum değeri kullanıma sunuldu:PENDING_CONFIRMATION
,DECLINED_BY_MERCHANT
veFAILED
. Eşzamansız rezervasyonlara ait oluşturma, ret ve başarısızlıkları işlerken bu yeni durum değerlerini kullanın. - Rezervasyon güncellemeleri: Rezervasyonların durumuyla ilgili eşzamansız tüm güncellemeler, Reservation Notification API'nin bookings.patch yöntemi aracılığıyla bildirilmelidir.
Aşağıdaki şemada, tipik bir eşzamansız rezervasyon etkileşiminde onay modu ve rezervasyon durumunun nasıl kullanıldığı gösterilmektedir.
- Kullanılabilirlik feed'leri, her müsaitlik durumu slotunun onay modu belirtilecek şekilde güncellendi. Bu bilgilerin feed'de bulunması önemlidir. Böylece, rezervasyonun eşzamansız yapısını akışın başlarında kullanıcıya açıklayabiliriz.
BatchAvailabilityLookup
veyaCheckAvailability
çağrıldığında onay modunu ve ideal olarak aynı onay modunu iletiriz. Bu, kullanıcıya uygun mesajın gösterilmesini sağlar.CreateBooking
çağrıldığında, öngörülen onay modunu belirtmek için onay modunu iletiriz. Eşzamansız rezervasyon isteği gönderildiğinde, rezervasyonPENDING_MERCHANT_CONFIRMATION
durumuyla döndürülür.- Satıcı bir rezervasyon isteğini kabul ettiğinde veya reddettiğinde rezervasyon durumu, gerçek zamanlı güncelleme Reservation Notification API'nin bookings.patch yöntemi aracılığıyla güncellenir. Zamanında yanıtlanmayan rezervasyonları otomatik olarak reddetmek isterseniz bunu aynı gerçek zamanlı güncelleme yöntemini kullanarak yapın.
Stok Durumu Feed'leri
Müsaitlik durumu feed'inde her alanın eşzamanlı mı yoksa eşzamansız mı olduğunu belirtin. Bunu yapmak için yeni confirmation_mode
alanını ayarlayın.
// Mode by which bookings for an availability slot are confirmed. // enum ConfirmationMode { // The confirmation mode was not specified. // Synchronous confirmation will be assumed. CONFIRMATION_MODE_UNSPECIFIED = 0; // Bookings for this availability will be confirmed synchronously. CONFIRMATION_MODE_SYNCHRONOUS = 1; // Bookings for this availability will be confirmed asynchronously. CONFIRMATION_MODE_ASYNCHRONOUS = 2; }
Hiçbir mod belirtilmezse onay modunun eşzamanlı olduğu varsayılsa da, yanlışlıkla yapılan atlamalarla ilgili karışıklığı ortadan kaldıran bir modun açıkça belirtilmesi önemle tavsiye edilir.
Asenk.
{ "availability": [ { "merchant_id": "10001", "service_id": "1000", "spots_open": 3, "spots_total": 3, "duration_sec": 3600, "start_sec": 1535806800, "resources": { "party_size": 4 }, "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" } ] }
Sync
{ "availability": [ { "merchant_id": "10001", "service_id": "1000", "spots_open": 3, "spots_total": 3, "duration_sec": 3600, "start_sec": 1535806800, "resources": { "party_size": 4 }, "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" } ] }
Eş Zamansız ve Senkronize
{ "availability": [ { "merchant_id": "10001", "service_id": "1000", "spots_open": 3, "spots_total": 3, "duration_sec": 3600, "start_sec": 1535806800, "resources": { "party_size": 4 }, "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" }, { "merchant_id": "10002", "service_id": "1000", "spots_open": 4, "spots_total": 4, "duration_sec": 3600, "start_sec": 1535806800, "resources": { "party_size": 2 }, "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" } ] }
Rezervasyon Sunucusu
BatchAvailabilityLookup veya CheckAvailability
BatchAvailabilityLookupResponse
(BAL) veya CheckAvailabilityResponse
(CA) sisteminde, stok durumu feed'inde belirtilen ve BatchAvailabilityLookupRequest
ya da CheckAvailabilityRequest
ile iletilen confirmation_mode
değerini döndürür.
BAL Eş Zamansız
{ "slot_time_availability": [ { "slot_time": { "duration_sec": "3600", "resource_ids": { "party_size": 3 }, "service_id": "1000", "start_sec": "1546458300", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" }, "available": true } ] }
BAL Senkronizasyonu
{ "slot_time_availability": [ { "slot_time": { "duration_sec": "3600", "resource_ids": { "party_size": 3 }, "service_id": "1000", "start_sec": "1546458300", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" }, "available": true } ] }
CA Eş Zamansız
{ "slot": { "duration_sec": "3600", "merchant_id": "317652", "resources": { "party_size": 3 }, "service_id": "1000", "start_sec": "1546458300", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" }, "count_available": 1, "duration_requirement": "DO_NOT_SHOW_DURATION" }
CA Senkronizasyonu
{ "slot": { "duration_sec": "3600", "merchant_id": "317652", "resources": { "party_size": 3 }, "service_id": "1000", "start_sec": "1546458300", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" }, "count_available": 1, "duration_requirement": "DO_NOT_SHOW_DURATION" }
CreateBooking
Aşağıdaki kullanılabilir seçenekleri kullanarak rezervasyon için doğru durumu ilettiğinizden emin olun:
// Status of a booking. // // Updating booking status does not change the status of the associated payment. // Prepayment status updates should be done using the PrepaymentStatus enum. enum BookingStatus { // Not specified. BOOKING_STATUS_UNSPECIFIED = 0; // Booking has been confirmed CONFIRMED = 1; // Booking is awaiting confirmation by the merchant before it can transition // into CONFIRMED status. Only applicable to non-payments Dining or // Beauty verticals. PENDING_MERCHANT_CONFIRMATION = 2; // Booking has been canceled on behalf of the user. // The merchant can still trigger a manual refund. CANCELED = 3; // User did not show for the appointment NO_SHOW = 4; // User did not show for the appointment in violation of the cancellation // policy. NO_SHOW_PENALIZED = 5; // Booking could not be completed by the async backend due to a failure. FAILED = 6; // Booking was asynchronously declined by the merchant. Only applicable to // non-payments Dining or Beauty verticals. DECLINED_BY_MERCHANT = 7; }
CreateBookingResponse
içinde, rezervasyonun CreateReservationRequest'te sağlanan toplu slotu için geçerli confirmation_mode
değerini döndürün. Ayrıca, rezervasyon eşzamansız olduğunda status
özelliğini PENDING_MERCHANT_CONFIRMATION
olarak ayarlayın. confirmation_mode
'nin kullanıcının kafasını karıştırmamasını beklediği gibi olduğundan ve Google ile Rezervasyon'un kullanıcının kafasını karıştırmamasını beklediğinden emin olun.
Asenk.
{ "booking": { "slot": { "duration_sec": "3600", "merchant_id": "100001", "resources": { "party_size": 2 }, "service_id": "1000", "start_sec": "1546647234", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" }, "user_information": { "email": "johnsmith@gmail.com", "family_name": "John", "given_name": "Smith", "telephone": "+1 800-123-4567", "user_id": "2017492857928759285" }, "payment_information": { "prepayment_status": "PREPAYMENT_NOT_PROVIDED" }, "status": "PENDING_MERCHANT_CONFIRMATION" } }
Sync
{ "booking": { "slot": { "duration_sec": "3600", "merchant_id": "100001", "resources": { "party_size": 2 }, "service_id": "1000", "start_sec": "1546647234", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" }, "user_information": { "email": "johnsmith@gmail.com", "family_name": "John", "given_name": "Smith", "telephone": "+1 800-123-4567", "user_id": "2017492857928759285" }, "payment_information": { "prepayment_status": "PREPAYMENT_NOT_PROVIDED" }, "status": "CONFIRMED" } }
UpdateBooking
Eş zamansız sürümün ilk sürümünde, mevcut bir rezervasyonda kullanıcı tarafından yapılan değişiklikler desteklenmez. Bunun yerine, kullanıcının rezervasyonu iptal etmesi ve yeni bir rezervasyon oluşturması gerekir.
Gerçek Zamanlı Güncellemeler
Müsaitliklerle ilgili gerçek zamanlı güncellemeler için confirmation_mode
belirtilmelidir. Bu, aşağıdaki yöntemler için geçerlidir:
Envanter RTU (ReplaceServiceAvailability veya BatchReplaceServiceAvailability)
availability.replace
(toplu) yöntemini veya services.availability.replace
yöntemini kullanarak Availability
içinde confirmation_mode
öğesini CONFIRMATION_MODE_ASYNCHRONOUS
olarak ayarlayın
Asenk.
{ "extendedServiceAvailability": [ { "merchantId": "1001", "serviceId": "12310", "startTimeRestrict": "2014-10-02T15:01:23.045123456Z", "endTimeRestrict": "2014-10-02T19:01:23.045123456Z", "availability": [ { "startTime": "2014-10-02T15:30:00.00Z", "duration": "3600s", "spotsOpen": "0", "spotsTotal": "2", "availabilityTag": "1000001", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" } ] } ] }
Sync
{ "extendedServiceAvailability": [ { "merchantId": "1001", "serviceId": "12310", "startTimeRestrict": "2014-10-02T15:01:23.045123456Z", "endTimeRestrict": "2014-10-02T19:01:23.045123456Z", "availability": [ { "startTime": "2014-10-02T15:30:00.00Z", "duration": "3600s", "spotsOpen": "0", "spotsTotal": "2", "availabilityTag": "1000001", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" } ] } ] }
Eş Zamansız ve Senkronize
{ "extendedServiceAvailability": [ { "merchantId": "1001", "serviceId": "12310", "startTimeRestrict": "2014-10-02T15:01:23.045123456Z", "endTimeRestrict": "2014-10-02T19:01:23.045123456Z", "availability": [ { "startTime": "2014-10-02T15:30:00.00Z", "duration": "3600s", "spotsOpen": "0", "spotsTotal": "2", "availabilityTag": "1000001", "confirmation_mode": "CONFIRMATION_MODE_ASYNCHRONOUS" }, { "startTime": "2014-10-03T11:00:00.00Z", "duration": "5400s", "spotsOpen": "1", "spotsTotal": "1", "availabilityTag": "1000002", "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS" } ] } ] }
Rezervasyon Bildirimi API'si
Bir rezervasyon durumunda yapılan eşzamansız güncellemeler, Reservation Notification API bookings.patch yöntemi aracılığıyla yapılmalıdır.
Durumu güncellerken status
alanının adını updateMask
bölümüne eklediğinizden emin olun.
Durum | Açıklama |
---|---|
ONAYLANDI | satıcı, rezervasyonu onayladı |
BAŞARISIZ | İş ortağı, satıcıyla rezervasyonu onaylayamadı veya reddedemedi |
DECLINED_BY_MERCHANT | satıcı, rezervasyonu reddetti |
Request: PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/<PARTNER_ID>/bookings/<BOOKING_ID>?updateMask=status Body: {"name":"partners/<PARTNER_ID>/bookings/<BOOKING_ID>", "status":"DECLINED_BY_MERCHANT"}
Rezervasyon hatası durumunda rezervasyon durumunu FAILED
olarak ayarlayın ve purchase_failure değerini belirtin. Durum başka bir değere ayarlanırsa booking_failure
yoksayılır.
Request: PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/<PARTNER_ID>/bookings/<BOOKING_ID>?updateMask=status&booking_failure.cause="SLOT_UNAVAILABLE" Body: {"name":"partners/<PARTNER_ID>/bookings/<BOOKING_ID>", "status":"FAILED"}
E-posta Bildirimleri
Eşzamansız rezervasyonlar için kullanıcılara gönderilen rezervasyonun durumuyla ilgili beş potansiyel e-posta bulunur.
PENDING_MERCHANT_CONFIRMATION
CONFIRMED
DECLINED_BY_MERCHANT
FAILED
CANCELED