Rezervasyon Bekleme Listeleri programına katılan iş ortakları, programa başlamadan önce hesap Kurulumu'nu tamamlamalıdır. Ancak genel kılavuzda yer alan bazı adımlar, bekleme listesi özelliğini kullanmak için gerekli değildir. Bu sayfada, Google ile Rezervasyon'da bekleme listesi özelliğini kullanmak isteyen iş ortakları için hangi adımların geçerli olduğu açıklanmaktadır. Entegrasyon adımlarını uygulamadan önce bu genel bakışı okumanızı öneririz.
Lansman süreci
Şekil 1'de, bekleme listesinde olan satıcılarınızı Actions Center'da kullanıma sunma işlemi özetlenmiştir.
Genel olarak, sizinle (İş Ortağı) Google arasında gerçekleşen önemli veri akışları Şekil 2'de gösterilmiştir:
Tüm Reservations Waitlists iş ortakları için kurallar
Rezervasyon bekleme listeleri özelliğini uygularken aşağıdakileri göz önünde bulundurun:
- Her rezervasyon bekleme listesi satıcısı için hizmetin
waitlist_rules
doldurulması gerekir.- Hem bekleme listesi hem de rezervasyon için aynı hizmeti kullanmanız gerekir. Yani, restoranınız rezervasyonlara da izin veriyorsa rezervasyon için bekleme listesi ile ilgili meta verileri hizmete eklemeniz yeterlidir.
- Bekleme listesi uygulaması için SMS güncellemeleri göndermek aşağıdaki durumlarda gereklidir:
- Kullanıcının bekleme listesine başarıyla katıldığını onaylamak için.
- Kullanıcıya masasının hazır olduğunu bildirmek için.
- Kullanıcıya, bekleme listesi girişinin iptal edildiğini bildirmek için.
- SMS mesajları, kullanıcıların bekleme listesi durumlarını görüntüleyebilecekleri bir sayfanın bağlantısını içermelidir.
- Yalnızca bekleme listesinde olan satıcıların, Actions Center'a stok durumu feed'leri sağlaması gerekmez.
- Rezervasyon sunucunuz, Rezervasyon sunucusunu uygulama bölümünde listelenen, bekleme listesine özgü tüm adımları uygulamalıdır. Hem rezervasyonları hem de bekleme listelerini destekleyen iş ortakları, mevcut rezervasyon sunucularına yeni yöntemleri ekleyebilir.
- İşlemler Merkezi, rezervasyon sunucusundaki bekleme listesi yöntemleri için bir dizi test senaryosu çalıştırır.
Durum akış şeması
Bu grafikte,
GetWaitlistEntry
çağrılarına yanıt verirken
WaitlistEntry.waitlist_entry_state
bildirilmesi gereken durumlar açıklanmaktadır. Grafikte,
WaitlistEntry.waitlist_entry_state_times.*_time_seconds
alanlarının ne zaman kaydedilip doldurulacağı ve kullanıcıya yeni bir duruma girdiklerini bildirmek için ne zaman SMS gönderileceği de belirtilir.
Sık karşılaşılan uç durumlar
Aşağıda, rezervasyon bekleme listeleri entegrasyonunda yaygın olarak karşılaşılan uç durumlar ve bunlar için tercih edilen çözümler verilmiştir.
-
Bazı (ancak tümü değil) grup boyutları için bekleme süresi olmadığından yeni bekleme listesi eklemeleri kabul edilmiyorsa
BatchGetWaitEstimates
yanıtında tüm grup boyutları içinWaitEstimates
döndürülmesi ve kullanıcıların bu grup boyutları için bekleme süresi olmadan bekleme listesine katılmasına izin verilmesi tercih edilir. Beklemedenparty_size
için 0parties_ahead_count
ve/veya 0start_seconds
ve 0end_seconds
içeren birestimated_seat_time_range
ile birlikte 0WaitLength
döndürme -
Bekleme süresi çok uzun olduğu için bir veya daha fazla parti büyüklüğü yeni bekleme listesi eklemelerini kabul etmiyorsa
BatchGetWaitEstimates
yanıtında bu parti büyüklükleri içinWaitEstimates
öğesinin atlanması tercih edilir.
Satıcının bekleme listesi tamamen açık olmasa bile kullanıcıya seçenekler sunduğundan bu yaklaşımlar tercih edilir.
Yalnızca Reservations Waitlists kullanan iş ortakları için kurallar
Rezervasyon sunucusu yalnızca bekleme listeleri için kullanılıyorsa aşağıdakileri göz önünde bulundurun:
- Yalnızca rezervasyon bekleme listeleri olan iş ortakları, Google ile Rezervasyon'a doluluk feed'leri sağlamaz.
- Yalnızca rezervasyon bekleme listeleri olan iş ortakları, rezervasyon yöntemlerini rezervasyon sunucularında uygulamaz. Bunun yerine, bekleme listesi uygulama talimatlarını kullanarak rezervasyon sunucusunu uygulayın.
- Yalnızca Reservations Waitlists kullanan iş ortakları Google'a API çağrısı yapmaz. Bu, yalnızca rezervasyon bekleme listelerinde yer alan iş ortaklarının bulut projesi oluşturması veya geliştirici e-posta adresi sağlaması gerekmediği anlamına gelir. Anlık API güncellemeleri'ni tamamlamanız gerekmez. Ancak satıcı ve hizmet feed'lerinin İşlem Merkezi'ne eklenmesi gerekir.
Satıcılarının bekleme listesindeki eklemeleri manuel olarak kabul etmesi/reddetmesi gereken iş ortakları için kurallar
Satıcılarınızın, Google'dan gelen yeni bekleme listesi eklemelerini manuel olarak kabul etmesi veya reddetmesi gerekiyorsa ek adımlar gerekir:
- Manuel onay gerektiren grup boyutları için
waitlist_confirmation_mode
'üwait_estimate
'deWAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS
olarak ayarlayın. Bu,BatchGetWaitEstimateResponse
veGetWaitlistEntryResponse
içinde ayarlanmalıdır. - Kullanıcı tarafından istenen ancak satıcı tarafından henüz kabul edilmeyen bekleme listesi girişleri
PENDING_MERCHANT_CONFIRMATION
durumunda olmalıdır.
Reservations Waitlists test durumları
Google, rezervasyon sunucusu uygulamanızdaki bekleme listesi yöntemlerinin işlevselliğini sağlamak için aşağıdaki kullanım alanlarını test eder. Google, gecikmeyi de test edip izler. Bu testlerin tümü, yayınlanmadan önce geçmelidir.
Bekleme süresi tahmini alma
- Beklemede kalma tahminleri,
BatchGetWaitEstimatesRequest
içinde istenen her parti büyüklüğü için döndürülür. - Satıcının yeni bekleme listesi eklemelerini kabul etme veya reddetme seçeneğine sahip olduğu parti boyutları için waitlist_confirmation_mode değerini
WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS
olarak ayarlayın.
Bekleme listesi girişi oluşturma
CreateWaitlistEntry
isteğinden bekleme listesi girişi oluşturulabilir.- Bekleme listesi girişi oluşturma işlemi başarısız olursa yanıtta bir iş mantığı hatası gösterilir.
- Bir
CreateWaitlistEntry
denemesi başarılı olursa aynıCreateWaitlistEntry
tekrar alındığında aynı yanıt döndürülür. - Bir
CreateWaitlistEntry
girişimi başarısız olursa sunucu, aynıCreateWaitlistEntry
tekrar alındığında tekrar dener. - Bekleme listesi girişleri satıcının arayüzünde gösterilir.
GetWaitlistEntry
adresine yapılan aramalar, oluşturulan bekleme listesi girişini başarıyla döndürür.
Bekleme listesi girişi durumları ve zaman damgaları
- Her bekleme listesi giriş durumunun,
GetWaitlistEntry
yanıtlarının bekleme listesi girişinde doğru şekilde döndürüldüğünü doğrulayın. - Her durum zaman damgasının,
GetWaitlistEntry
yanıtlarındaki bekleme listesi girişinin uygun zaman damgası alanında ayarlandığını doğrulayın.
Bekleme listesi girişini silme
- Mevcut bekleme listesi girişleri silinebilir. Başarılı bir silme işlemine verilen yanıt, boş proto
{}
olmalıdır.
Devre dışı bırak
- Devre dışı bırakılan satıcıların Satıcının devre dışı bırakılması bölümünde açıklandığı şekilde ele alındığını doğrulayın.
Örnek bekleme listesi hizmet feed'i (JSON)
Bekleme listesi hizmet feed'iSatıcının kapsam dışında kalması
Google, daha önce bekleme listesi etkinleştirmiş ancak bu özelliği devre dışı bırakmaya karar vermiş satıcılardan belirli yanıtlar bekler.
Hemen devre dışı bırakma
BatchGetWaitEstimates
istekleri içinCLOSED_OTHER
döndürülür.CreateWaitlistEntry
isteklerindeWAITLIST_CLOSED
döndürülür.- Bekleme listesinde bulunan kullanıcılar için
GetWaitlistEntry
isteklerini doğru şekilde döndürün.
Genişletilmiş kapsam dışında kalma
- Satıcı rezervasyonları devre dışı bırakmıyorsa
waitlist_rules
öğesini satıcının hizmet feed'inden kaldırın. - Tüm Google entegrasyonları devre dışı bırakılırsa satıcıyı satıcı feed'inden kaldırın.