Rezervasyon Bekleme Listeleri programına katılan iş ortakları, başlamadan önce hesap Kurulum işlemini tamamlamalıdır. Ancak genel kılavuzdaki bazı adımlar, bekleme listesi özelliğini kullanmak için gerekli değildir. Bu sayfadaki yönergelerde, 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.
Başlatma işlemi
Şekil 1'de, bekleme listesi etkin olan satıcılarınızı Actions Center'da kullanıma sunma süreci özetlenmiştir.
![Şekil 1: Üst düzey entegrasyon adımları](https://developers.google.cn/static/actions-center/images/waitlists/reserve_with_google_waitlist_integration.png?authuser=5&hl=tr)
Genel olarak, siz (İş Ortağı) ve Google arasındaki ana veri akışları Şekil 2'de gösterilmiştir:
![Şekil 2: Entegrasyon veri akış diyagramı](https://developers.google.cn/static/actions-center/images/waitlists/waitlist_integration_data_flow_diagram.png?authuser=5&hl=tr)
Tüm Rezervasyon Bekleme Listeleri iş ortakları için kurallar
Rezervasyon Bekleme Listeleri özelliğini uygularken aşağıdakileri göz önünde bulundurun:
- Her Rezervasyon Bekleme Listeleri satıcısının hizmetinde
waitlist_rules
doldurulmuş olmalıdır.- Hem bekleme listesi hem de rezervasyon için aynı hizmeti kullanmanız gerekir. Başka bir deyişle, restoranınız rezervasyonlara da izin veriyorsa bekleme listesiyle ilgili meta verileri rezervasyon için hizmete eklemeniz yeterlidir.
- Aşağıdaki durumlarda bekleme listesi uygulaması için SMS güncellemeleri
göndermeniz gerekir:
- Kullanıcının bekleme listesine başarıyla katıldığını onaylamak için.
- Kullanıcıya tablosunun hazır olduğunu bildirmek için.
- Kullanıcıyı bekleme listesi girişinin iptal edildiğini bildirmek için kullanın.
- SMS mesajları, kullanıcıların bekleme listesi durumlarını görüntüleyebileceği bir sayfanın bağlantısını içermelidir.
- Yalnızca bekleme listesindeki satıcıların, Actions Center'a müsaitlik durumu feed'leri sağlamasına gerek yoktur.
- Rezervasyon sunucunuz, Rezervasyon sunucusunu uygulama sayfasında listelenen tüm bekleme listesine özel adımları uygulamalıdır. Hem rezervasyonları hem de bekleme listelerini destekleyen iş ortakları, yeni yöntemleri mevcut rezervasyon sunucularına ekleyebilir.
- Actions Center, rezervasyon sunucusunda bekleme listesi yöntemleri için bir test durumu çalıştırır.
Durum akış şeması
Bu grafikte,
GetWaitlistEntry
çağrılarına yanıt verirken
WaitlistEntry.waitlist_entry_state
içinde 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 girdiğini bildirmek için ne zaman SMS gönderileceği de belirtilir.
![Şekil 3: Bekleme listesi durumu akış şeması](https://developers.google.cn/static/actions-center/images/waitlists/waitlist_status_flowchart.png?authuser=5&hl=tr)
Yaygın uç durumlar
Rezervasyon Bekleme Listeleri entegrasyonuyla ilgili yaygın uç durumlar ve bunlar için tercih edilen çözümler aşağıda verilmiştir.
-
Bazı (ancak tümü değil) grup boyutları, bu taraf boyutları için bekleme gerekmediği için yeni bekleme listesi eklemelerini kabul etmiyorsa
BatchGetWaitEstimates
yanıtında tüm grup boyutları içinWaitEstimates
döndürülmesi ve kullanıcıların beklemeden bu parti boyutları için bekleme listesine katılmasına izin verilmesi tercih edilir. 0parties_ahead_count
ve/veya 0start_seconds
ve 0end_seconds
içerenparty_size
öğelerini beklemeden döndürünWaitLength
estimated_seat_time_range
-
Bir veya daha fazla grup boyutu, bekleme süresi çok uzun olduğu için yeni bekleme listesi eklemelerini kabul etmiyorsa
BatchGetWaitEstimates
yanıtında bu taraf boyutları içinWaitEstimates
alanının atlanması tercih edilir.
Bu yaklaşımlar, satıcının bekleme listesi tam olarak açık olmasa bile kullanıcıya seçenek sunduğu için tercih edilir.
Rezervasyon Bekleme Listelerindeki 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 müsaitlik durumu feed'leri sağlamaz.
- Yalnızca rezervasyon bekleme listelerindeki iş ortakları, rezervasyon yöntemlerini rezervasyon sunucularına uygulamaz. Bunun yerine, Bekleme listesi uygulaması için talimatları uygulayarak rezervasyon sunucusunu uygularsınız.
- Yalnızca rezervasyon bekleme listeleri olan iş ortakları Google'a API çağrıları yapmaz. Bu, yalnızca Rezervasyon Bekleme Listelerindeki iş ortaklarının bir bulut projesi oluşturmasına veya geliştirici e-posta adresi sağlamasına gerek olmadığı anlamına gelir. Gerçek zamanlı API güncellemelerini tamamlamanız gerekmez. Ancak satıcı ve hizmet feed'lerinin hâlâ Actions Center'a sağlanması gerekir.
Satıcılarının bekleme listesi eklemelerini manuel olarak kabul etmesi/reddetmesi gereken iş ortaklarına yönelik kurallar
Satıcılarınız, Google'ın yaptığı yeni bekleme listesi eklemelerini manuel olarak kabul etmeyi veya reddetmeyi gerekli kılıyorsa ek adımlar gerekir:
- Manuel onay gerektiren grup boyutları için
wait_estimate
alanındawaitlist_confirmation_mode
değeriniWAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS
olarak ayarlayın. Bu,BatchGetWaitEstimateResponse
veGetWaitlistEntryResponse
içinde ayarlanmalıdır. - Kullanıcı tarafından istenen ancak henüz satıcı tarafından kabul edilmeyen bekleme listesi girişleri
PENDING_MERCHANT_CONFIRMATION
durumunda olmalıdır.
Rezervasyon Bekleme Listeleri test durumları
Google, rezervasyon sunucusu uygulamanızda bekleme listesi yöntemlerinin işlevselliğini sağlamak için aşağıdaki kullanım alanlarını test eder. Google ayrıca gecikmeyi test edip izler. Bu testlerin tümü lansmandan önce geçmelidir.
Bekleme Tahmini alma
BatchGetWaitEstimatesRequest
öğesinde istenen her grup boyutu için bekleme tahminleri döndürülür.- Satıcının yeni bekleme listesi eklemelerini kabul etme veya reddetme seçeneğine sahip olduğu grup 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şturulamadığı takdirde 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
denemesi başarısız olursa aynıCreateWaitlistEntry
tekrar alındığında sunucu işlemi yeniden dener. - Bekleme listesi girişleri satıcının arayüzünde gösterilir.
GetWaitlistEntry
çağrıları, oluşturulan bekleme listesi girişini başarıyla döndürür.
Bekleme listesi giriş 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 bir 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şleminin yanıtı boş protokol
{}
olmalıdır.
Devre dışı bırak
- Devre dışı bırakılan satıcıların, Satıcıyı devre dışı bırakma bölümünde açıklandığı gibi değerlendirildiğini doğrulayın.
Örnek bekleme listesi hizmet feed'i (JSON)
Bekleme listesi hizmet feed'iSatıcıyı devre dışı bırak
Google, daha önce bekleme listelerini etkinleştirmiş olan ancak kapsam dışında kalmaya karar veren satıcıların belirli yanıtlar vermesini bekler.
Hemen devre dışı bırak
BatchGetWaitEstimates
istekleri içinCLOSED_OTHER
döndürün.CreateWaitlistEntry
istekleri içinWAITLIST_CLOSED
kodunu döndürün.- Zaten bekleme listesinde olan kullanıcılar için
GetWaitlistEntry
isteklerini düzgün bir şekilde döndürün.
Kapsamı genişletilmiş devre dışı bırakma
- Satıcı rezervasyonları devre dışı bırakmıyorsa
waitlist_rules
özelliğini satıcının hizmet feed'inden kaldırın. - Tüm Google entegrasyonlarının kapsamı dışında kalmayı seçtiyse satıcıyı satıcı feed'inden kaldırabilirsiniz.