En iyi uygulamalar

Aşağıdaki en iyi uygulamalar, İşlem Merkezi Yerel Hizmet Reklamları uçtan uca entegrasyonu için geçerlidir ve kullanılabilirlik ile performans sorunlarını önlemek için kullanılabilir. Düşük veri kalitesi, envanterin yayından kaldırılmasına neden olabilir.

Feed'ler

  • Bir hizmetin belirli bir uzunluğu yoksa müsaitlik durumu feed'inde duration_sec değerini aşağıdakilerden birine ayarlayın:
    • Hizmetin makul bir şekilde gerçekleştirilmesi için gereken saniye sayısı.

    • Hizmetin tamamlanması için gereken ortalama saniye sayısı.

  • Satıcının feed'indeki Category alan girişinin özgün olmasını sağlayın. Örneğin, bir restoran Fransız veya Japon gibi belirli bir türde yemekler sunduğunu belirtebilir. Ayrıntılar için olası kategori değerlerine dair Yer türleri bölümüne bakın.

  • Satıcı feed'inin Terms alanında satıcıya özel hizmet şartlarını ayarlayarak Rezervasyon yap düğmesinin altında aşağıdaki notun görünmesini sağlayın:

    Devam ederek <merchant>'ın Hizmet Şartları
    'nı kabul etmiş olursunuz. Bu durumda "Hizmet Şartları", tıklandığında sözleşme metin alanında ayarlanan metni gösteren bir bağlantıdır.

  • gzip kullanarak feed'lerinizi sıkıştırma

Rezervasyon sunucusu

Haritalar Rezervasyon API'sini entegrasyonunuzu optimize etmek için aşağıdakileri yapın:

  • UNIX zaman damgalarını her zaman UTC biçiminde kullanın.
  • CreateBooking API'de yeni bir rezervasyon yapıldığında benzersiz bir rezervasyon kimliği oluşturun.

Gerçek zamanlı güncellemeler

Rezervasyon işlemi sırasında en iyi kullanıcı deneyimini sağlamak için aşağıdakileri yapın:

  • Standart bir uygulama için bir randevunun başlangıç zamanını, süresini ve rezervasyon durumunu (ör. iptal veya randevuya gelmeme) değiştirmek üzere BookingNotifications API'yi kullanın.
  • İşlem Merkezi rezervasyonunda sizin tarafınızdan yapılan herhangi bir değişiklikten sonra, verilerin İşlem Merkezi tarafında eskimemesi için BookingNotification API ile sistemden gerçek zamanlı rezervasyon güncellemeleri gönderin. Örneğin, İşlem Merkezi'nde sisteminizdeki bir rezervasyonu iptal edebilir, yeniden planlayabilir veya güncelleyebilirsiniz.
  • UpdateBookingRequest kaynağından gelen her rezervasyon güncellemesinde, UpdateBookingResponse değerinin rezervasyon kimliğini içerdiğinden ve güncellenen tüm alanların yeni değeri yansıttığından emin olun.
  • Envanter RTU uygulanıyorsa
    • Müsaitlik durumunu yalnızca API çağrısı başına 100-1.000 slotluk gruplar halinde güncelleyin.
    • Düzenleme hedefini daraltmak, yük boyutunu azaltmak ve çok fazla değişmeyen veriyi yeniden göndermekten kaçınmak için *Restrict (startTimeRestrict gibi) alanlarını kullanın.
    • Birden fazla iş parçacığı oluşturursanız eksponansiyel geri yükleme uygulayarak akış kısıtlama hatalarını önleyin. Üslü geri çekilmeyi doğru şekilde uygulamazsanız RESOURCE_EXHAUSTED kota hatası alabilirsiniz. Bu sorunları gidermek için üstel geri çekmeyi yeniden deneyebilirsiniz. Ancak ReplaceServiceAvailability'ü çalıştırdığınızda sunucunuzun kotalara sık sık ulaştığını fark ederseniz sunucunuzu stok durumu için toplu değiştirme yapacak şekilde yapılandırın. Bu çözüm, sunucunuzun yapması gereken API çağrılarının sayısını azalttığı için kota hatalarını önler.
  • API çağrısı yanıt süre sınırlarınızı bir saniyenin altına ayarlayın. Sunucunuzun, en az% 95 oranında saniyenin altında gecikmeyle saniyede beş sorguyu (QPS) işleyebildiğinden emin olun.