Bekleme listelerine giriş

Bekleme listesi programına katılan iş ortakları, başlamadan önce hesap Kurulumu'nu tamamlamalıdır. Ancak genel kılavuzdaki bazı adımlar, bekleme listesi özelliğinin kullanılması için gerekli değildir. Bu sayfadaki yönergeler, Google ile Rezervasyon'daki bekleme listesi özelliğini kullanmak isteyen iş ortakları için geçerli olan adımları açıklar. Entegrasyon adımlarını uygulamadan önce bu genel bakışı okumanızı öneririz.

Başlatma işlemi

Şekil 1'de, bekleme listesi etkin satıcılarınızı Google ile Rezervasyon'da başlatma süreci özetlenmiştir.

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

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

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

Tüm bekleme listesi iş ortakları için kurallar

Bekleme listesi özelliğini uygularken aşağıdakileri göz önünde bulundurun:

  • Her bekleme listesi satıcısının hizmetinde waitlist_rules doldurulmuş olmalıdır.
    • Hem bekleme listesi hem rezervasyon için aynı hizmeti kullanmanız gerekir. Başka bir deyişle, restoranınız da rezervasyona izin veriyorsa rezervasyon için bekleme listesine ilgili meta verileri hizmete eklemeniz yeterlidir.
  • Aşağıdaki durumlarda, bekleme listesi uygulaması için SMS güncellemeleri göndermek 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ıya, bekleme listesi girişinin iptal edildiğini bildirmek için.
  • SMS mesajları, kullanıcıların bekleme listesi durumlarını görebilecekleri bir sayfaya bağlantı içermelidir.
  • Yalnızca bekleme listesinde bulunan satıcıların, Google ile Rezervasyon'a stok durumu feed'i sağlaması gerekmez.
  • Rezervasyon sunucunuz, Rezervasyon sunucusunu uygulama bölümünde listelenen bekleme listesine özel tüm adımları uygulamalıdır. Hem rezervasyonları hem de bekleme listelerini destekleyen iş ortakları, mevcut rezervasyon sunucularına yeni yöntemler ekleyebilir.
  • Google ile Rezervasyon, rezervasyon sunucusundaki bekleme listesi yöntemleri için bir dizi 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. Grafik, WaitlistEntry.waitlist_entry_state_times.*_time_seconds alanlarının ne zaman kaydedilip doldurulacağını ve kullanıcıya yeni bir duruma girdiğini bildirmek için SMS'in ne zaman gönderileceğini de belirtir.

Şekil 3: Bekleme listesi durum akış grafiği
Şekil: 3 Bekleme listesi durum akışı grafiği

Yaygın kullanım alanları

Aşağıda, bekleme listesi entegrasyonunda yaygın olarak görülen bazı yaygın durumlar ve bunlar için tercih edilen çözümler verilmiştir.

  • Bazı parti boyutları (ancak hepsi değil) yeni bekleme listesi eklemelerini kabul etmiyorsa BatchGetWaitEstimates yanıtındaki 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 ile ve/veya estimated_seat_time_range ile ve 0 ile start_seconds ve 0 ile end_seconds beklemeden WaitLength öğesini döndürün
  • Bekleme süresi çok uzun olduğundan bir veya daha fazla parti boyutu yeni bekleme listesi eklemelerini kabul etmiyorsa BatchGetWaitEstimates yanıtında bu parti boyutları için WaitEstimates çıkarılması tercih edilir.

Satıcının bekleme listesi tam olarak açık olmasa bile kullanıcı seçenekleri sunduğu için bu yaklaşımlar tercih edilir.

Yalnızca bekleme listesi iş ortakları için kurallar

Rezervasyon sunucusu yalnızca bekleme listeleri için kullanılıyorsa aşağıdakileri unutmayın:

  • Yalnızca bekleme listesine giren iş ortakları, Google ile Rezervasyon'a müsaitlik durumu feed'i sağlamaz.
  • Yalnızca bekleme listesine giren iş ortakları, rezervasyon yöntemlerini rezervasyon sunucularına uygulamaz. Bunun yerine, bekleme listesi uygulamasına yönelik talimatları uygulayarak rezervasyon sunucusunu uygularsınız.
  • Yalnızca bekleme listesinde bulunan iş ortakları Google'a API çağrısı yapmaz. Bu sayede, yalnızca bekleme listesinde bulunan iş ortaklarının bulut projesi kurması veya geliştirici e-posta adresi sağlaması gerekmez. Gerçek zamanlı API güncellemelerini tamamlamanız gerekmez. Bununla birlikte, satıcı ve hizmet feed'lerinin de Google ile Rezervasyon'a sağlanması gerekir.

Satıcılarının bekleme listesine eklemelerini manuel olarak kabul etmesi/reddetmesi gereken iş ortakları için kurallar

Satıcılarınız yeni bekleme listesine ekleme işlemlerini Google'dan manuel olarak kabul etmeyi veya reddetmeyi gerektiriyorsa ek adımlar gerekir:

  • Manuel olarak onay alınmasını gerektiren parti boyutları için waitlist_confirmation_mode ayarını wait_estimate içinde 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.

Bekleme listesi test durumları

Google, rezervasyon sunucusu uygulamanızda bekleme listesi yöntemlerinin çalıştığından emin olmak için aşağıdaki kullanım alanlarını test eder. Google, gecikmeyi de test edip izler. Bu testlerin tümü lansmandan önce yapılmalıdır.

Bekleme Tahmini alma

  • BatchGetWaitEstimatesRequest içinde istenen her bir taraf 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 parti boyutları için pendinglist_approval_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ığında yanıtta iş mantığı hatası görünür.
  • 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 yeniden denenir.
  • 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üyor.

Bekleme listesi giriş durumları ve zaman damgaları

  • GetWaitlistEntry yanıtın bekleme listesi girişinde her bekleme listesi giriş durumunun doğru şekilde döndürüldüğünü doğrulayın.
  • GetWaitlistEntry yanıtlarındaki bekleme listesi girişinin uygun zaman damgası alanında her durum zaman damgasının 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ş {} protokolü olmalıdır.

Devre dışı bırak

Bekleme listesi hizmet feed'i örneği (JSON)

Bekleme listesi hizmet feed'i

Satıcı kapsamı dışında kalmayı seç

Google, daha önce bekleme listeleri etkinleştirilmiş ancak bu özelliği devre dışı bırakmaya karar veren satıcılar için belirli yanıtlar almayı beklemektedir.

Hemen devre dışı bırak

Kapsamı dışında kalmayı seçen kullanıcı sayısı

  • Satıcı rezervasyonları devre dışı bırakmıyorsa satıcı için waitlist_rules öğesini hizmet feed'inden kaldırın.
  • Tüm Google entegrasyonlarını devre dışı bırakırlarsa satıcıyı feed feed'inden kaldırın.