Genel bakış

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.

Şekil 1: Genel entegrasyon adımları
Şekil 1: Üst düzey entegrasyon adımları

Genel olarak, sizinle (İş Ortağı) Google arasında gerçekleşen önemli veri akışları Şekil 2'de gösterilmiştir:

Şekil 2: Entegrasyon veri akışı şeması
Şekil 2: Entegrasyon veri akışı şeması

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.

Şekil 3: Bekleme listesi durumu akış şeması
Şekil: 3 Bekleme listesi durumu akış şeması

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çin WaitEstimates 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. Beklemeden party_size için 0 parties_ahead_count ve/veya 0 start_seconds ve 0 end_seconds içeren bir estimated_seat_time_range ile birlikte 0 WaitLength 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çin WaitEstimates öğ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_modewait_estimate'de WAITLIST_CONFIRMATION_MODE_ASYNCHRONOUS olarak ayarlayın. Bu, BatchGetWaitEstimateResponse ve GetWaitlistEntryResponse 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

Örnek bekleme listesi hizmet feed'i (JSON)

Bekleme listesi hizmet feed'i

Satı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

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.