Genel bakış

Bu genel bakış, Order with Google akışını ve sipariş karşılama web hizmetinizle nasıl etkileşimde bulunduğunu özetler.

Sıralama

Order with Google kullanıcı arayüzü, kullanıcının siparişe menü öğeleri ekleyip restoran tarafından sunulan hizmetlere bağlı olarak gel-al veya paket teslim alma kararlarına vardığı sırada kullanıcılarla gerçekleştirdiği tüm etkileşimleri yönetir. Bu deneyim, veri feed'lerinizde bulunan Restaurant, Service ve Menu varlıkları tarafından desteklenir.

Bir sonraki adım, kullanıcı tarafından oluşturulan Cart sonucunun web hizmetiniz tarafından işlendiği alışveriş sepeti doğrulama aşamasıdır.

Ödeme İşlemi

Ödeme işlemi, Google tarafından web hizmeti uç noktanıza yapılan ilk çağrıdır. Cart cihazının doğrulanmasından web hizmetiniz sorumludur. Öğelerin stok durumunu ve fiyatlandırmasını onaylamanız, vergi, indirim ve ücretleri hesaplayıp iade etmeniz ve sipariş teslimat adresini doğrulamanız gerekir.

Ödeme işlemi aşağıdaki sırayı izler:

  1. Order with Google hizmeti, sipariş karşılama web hizmeti uç noktanıza bir Cart içeren CheckoutRequestMessage gönderir.
  2. Web hizmetinizin, Cart hizmetindeki öğeleri mevcut fiyatlara, stok durumuna ve servis sağlayıcılara göre doğrulaması gerekir. Daha sonra indirimler, vergiler ve teslimat ücretleri dahil toplam fiyatı hesaplarsınız.
  3. Uç noktanız, başarılı istekler için değiştirilmemiş Cart içeren bir CheckoutResponseMessage ile yanıt verir. İşleme hatası yükseltmek veya gerekirse küçük değişiklikler önermek için CheckoutResponseMessage öğesine FoodErrorExtension eklenebilir.

Cart doğrulandıktan sonra kullanıcı, akışın sipariş gönderim aşamasına geçmeyi seçebilir.

Sipariş İşlemini Gönder

Sipariş verme işlemi, kullanıcı sipariş verdiğinde tetiklenir. Web hizmetinizin alışveriş sepetini yeniden doğrulaması, online ödemeler etkinse kart jetonunu işlemesi ve son olarak siparişin durumunu güncellemesi gerekir.

Sipariş gönderme süreci şu sırayı izler:

  1. Order with Google hizmeti, sipariş karşılama web hizmeti uç noktanıza bir Order içeren SubmitOrderRequestMessage gönderir. Devam etmeden önce arka ucunuzun Cart doğrulaması daha yapması gerekir.

  2. Web hizmetiniz, Order içinde bulunan ödeme ayrıntılarını işler ve genellikle aşağıdaki işlemleri gerçekleştirir:

    1. Jeton doğrulaması, sahtekarlık ve diğer uygunluk kontrollerini gerçekleştirin.
    2. Kartı yetkilendirin ve isteğe bağlı olarak ücret alın.

  3. Uç noktanız, durumu OrderUpdate ("Sipariş verildi" olan satın alma durumu), CONFIRMED ("Kabul edildi" satın alma durumu) veya REJECTED ("Satın alma durumu" reddedildi) OrderUpdate içeren bir SubmitOrderResponseMessage ile yanıt verir.

Sipariş verildikten sonra kullanıcı, hem sizden hem de Order with Google kullanıcı arayüzünden sipariş durumu güncellemelerini almayı bekler. Kullanıcıya sipariş onayı e-postası göndermeniz gerekir. Ayrıca, Google'a ilgili sipariş güncellemelerini göndermek için Eşzamansız Sipariş Güncelleme API'sını kullanıyorsunuz.

Eşzamansız Sipariş Güncelleme İşlemi

Sizin tarafınızdaki kullanıcı bildirimlerinden bağımsız olarak, aşağıdaki etkinlikler için de Google'a sipariş durumu güncellemeleri göndermeniz gerekir:

  1. OrderState'te yapılan değişiklikler (ör. CREATED'dan CONFIRMED'e ve CONFIRMED'den IN_TRANSIT'e geçişler).
  2. Sipariş öğelerindeki fiyat veya stok durumu gibi değişiklikler.
  3. Kullanıcı, müşteri destek kanallarınızdan birinden destek isteği tetiklediğinde.

Güncellemeler, web hizmeti uç noktanızdan OrderUpdate içeren bir AsyncOrderUpdateRequestMessage olarak gönderilir. Google, AsyncOrderUpdateResponseMessage ile yanıt verir.

Adım şeması

Aşağıdaki çizim, sipariş karşılama işlemlerinin web hizmetinizle nasıl etkileşimde bulunduğunu göstermektedir. Büyütmek için tıklayın.

Order with Google sipariş karşılama akışı

Sipariş karşılama uç noktanızı ayarlama

Order with Google işlemleri, web hizmetinizle iletişim kurmak ve gıda siparişlerinin işlenmesi, onaylanması ve güncellenmesi için JSON mesajlarını kullanır. Order with Google web hizmetini tasarlarken, Order with Google hizmetinden istek mesajları alan ve mesajları Google hizmetine döndürebilen bir URL uç noktası tanımlamalısınız. Uygulamanız aşağıdaki şartları karşılamalıdır:

  • Web hizmetinizin, Order with Google hizmetinden POST isteği olarak bir JSON mesajı alabilmesi gerekir.
  • Web hizmetiniz iş ortağı URL'si adı verilen, iş ortağı portalında belirttiğiniz herkesin erişebileceği bir URL uç noktası sağlamalıdır. Sipariş karşılama URL'si, ödeme yapmak ve siparişleri göndermek için kullanılır. Uygulamanız her iki istek türünü de işlemelidir.
  • Web hizmetinizin, Mesaj doğrulama yöntemini kullanarak Google'dan gelen mesajları doğrulayabilmesi gerekir.
  • URL uç noktası uygulamanız, tek bir uç nokta ile hem ödeme hem de sipariş karşılama işlemlerini işleyebilmelidir. Ödeme için tek bir URL uç noktanız ve gönderim siparişi için ayrı bir uç noktanız olamaz.

İstemci Kitaplıkları

Araçlar bölümündeki istemci kodu oluşturma aracı, web hizmetiniziFulfillment API spesifikasyonuna göre doğrulamak için kullanılabilir.