Genel bakış

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.

Genel olarak, siz (İş Ortağı) ve Google arasındaki ana veri akışları Şekil 2'de gösterilmiştir:

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.

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çin WaitEstimates döndürülmesi ve kullanıcıların beklemeden bu parti boyutları için bekleme listesine katılmasına izin verilmesi tercih edilir. 0 parties_ahead_count ve/veya 0 start_seconds ve 0 end_seconds içeren party_size öğelerini beklemeden döndürünWaitLengthestimated_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çin WaitEstimates 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ında waitlist_confirmation_mode değerini WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS olarak ayarlayın. Bu, BatchGetWaitEstimateResponse ve GetWaitlistEntryResponse 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'i

Satı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çin CLOSED_OTHER döndürün.
• CreateWaitlistEntry istekleri için WAITLIST_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.