Rezervasyon Sunucusu Hazır

İşlemler Merkezi'nin sizin adınıza rezervasyon oluşturmak ve güncellemek için geri arama yapmasına izin vermek üzere bir rezervasyon sunucusuna ihtiyacınız vardır. Bu sayede İşlemler Merkezi, kullanıcı adına sizinle randevu, rezervasyon ve yer ayırtma işlemleri oluşturabilir.

Korumalı alan ve üretim rezervasyon sunucularınızla bağlantıyı nasıl yapılandıracağınızı öğrenmek için Rezervasyon Sunucusu Kimlik Bilgilerini Yapılandırma başlıklı makaleyi inceleyin.

Gerçek Zamanlı Güncellemeler'e geçmeden önce aşağıdaki Rezervasyon Sunucusu Hazır görevlerini tamamlayın:

Sandbox rezervasyon akışı üzerinden Booking sunucusu isteklerine doğru ve gerçek zamanlı envanter ayrıntıları gönderdiğinizde her görev tamamlandı olarak işaretlenir ve yeşile döner. Rezervasyon sunucusu kilometre taşları 14 günlük bir süre boyunca analiz edilir.

REST API arayüzü uygulama

REST tabanlı bir API arayüzü uygulayın. Bu, Google'ın HTTPS üzerinden Rezervasyon Sunucusu istekleri göndermesine olanak tanır.

API arayüzü uygulamak için İşlemler Merkezi Sandbox ortamına bağlanan bir geliştirme veya Sandbox rezervasyon sunucusu oluşturun. Yalnızca korumalı alan sunucusu tamamen test edildikten sonra üretim ortamına geçin.

Google'ın tüm Rezervasyon Sunucusu istekleri, Rezervasyon Sunucusu sayfasında ayarlanan Rezervasyon Sunucusu URL'sine göre yapılır. Örneğin, URL'niz api.example.com/google olarak ayarlanmışsa tüm HealthCheck istekleri api.example.com/google/v3/HealthCheck adresine gönderilir.

Ortam değiştiriciyle hem Sandbox hem de üretim ortamları için doğru rezervasyon sunucusu uç noktasının yapılandırıldığından emin olun.

Güvenlik ve kimlik doğrulama

Rezervasyon sunucunuzla yapılan tüm iletişimler, temel kimlik doğrulama kullanılarak HTTPS üzerinden gerçekleşir. Sunucunuzu ayarlamanıza yardımcı olması için Qualys' SSL sunucu testi gibi herkese açık bir SSL veya TLS doğrulama aracı kullanmanızı öneririz.

Google'ın Rezervasyon Sunucunuza yaptığı tüm isteklerin kimliği, HTTPS temel kimlik doğrulamasıyla doğrulanır. Rezervasyon sunucunuzun temel kimlik doğrulama bilgilerini, şifresini ve kullanıcı adını İşlemler Merkezi'nin Rezervasyon Sunucusu yapılandırma sayfasına girebilirsiniz. Kimlik bilgileri altı ayda bir değiştirilmelidir.

Rezervasyon sunucunuzu oluşturma

Rezervasyon sunucusu, entegrasyonun sisteminizle nasıl iletişim kuracağını belirler ve rezervasyonları oluşturur veya günceller. Sandbox ve Üretim Rezervasyon Sunucularınıza bağlantıyı yapılandırmak için Rezervasyon Sunucusu Kimlik Bilgilerini Yapılandırma başlıklı makaleyi inceleyin.

Rezervasyon Sunucunuzun Google ile Rezervasyon'dan gelen bir isteğe verdiği her yanıtın doğru ve gerçek zamanlı envanter ayrıntılarını içermesi beklenir. Aşağıdaki tabloda her uygulama için yöntemler gösterilmekte ve hizmet protokolü biçimlerine bağlantılar yer almaktadır:

Yöntem Tanım Yanıt HTTP isteği
BatchAvailabilityLookup sayfa yükleme

Kullanıcılar satıcınız için Masa Ayırt'ı tıkladığında, sayfa yüklendiğinde BatchAvailabilityLookup isteği çağrılır.

Yük, Google ile Rezervasyon'un kullanılabilir olarak kabul ettiği, en son feed yüklemelerinize dayalı çok sayıda zaman aralığı içerir.

 Yanıt, her alan isteğini ve alanın mevcut müsaitlik durumunu içermelidir. Bu ayar, kullanılamayan tüm zaman aralıklarının gösterilmesini engeller. POST /v3/BatchAvailabilityLookup/
BatchAvailabilityLookup yuvası tıklaması Kullanıcıya rezervasyon için uygun zaman aralıkları gösterildiğinde ve kullanıcı bir zaman aralığını tıkladığında, zaman aralığı tıklaması için BatchAvailabilityLookup isteği çağrılır. Yanıtta, yuvanın mevcut ve gerçek kullanılabilirliği belirtilmelidir. Slot tıklanmadan önce rezervasyon dolarsa kullanılamadığını belirten yanıtı döndürün. POST /v3/BatchAvailabilityLookup/
CreateBooking Kullanıcı, rezervasyon modalında seçilen zaman aralığını rezerve etmek istediğini onayladığında CreateBooking isteği gönderilir.

Yanıt, rezervasyonun başarılı veya başarısız olduğunu belirtmelidir.

Rezervasyon başarısız olursa başarısızlığın nedenini belirtmeniz gerekir. Örneğin, CreateBooking yanıtı çağrılmadan önce yer ayırtılmış olabilir.

Başarılı bir rezervasyon oluşturulursa yanıt, gelecekteki isteklerde veya güncellemelerde rezervasyona başvurmak için benzersiz bir booking_id içerir.

 POST /v3/CreateBooking/
UpdateBooking Google ile Rezervasyon üzerinden yapılan bir rezervasyondan sonra kullanıcı, rezervasyonunu değiştirmeyi seçebilir. Kullanıcı rezervasyonunu güncellediğinde veya iptal ettiğinde UpdateBooking isteği gönderilir. CreateBooking yanıtında olduğu gibi, UpdateBooking yanıtınız rezervasyonun başarılı olduğunu göstermeli veya başarısızlığın nedenini belirtmelidir. POST /v3/UpdateBooking/
HealthCheck İşlemler Merkezi, altyapınızın etkin ve çalışır durumda olduğunu doğrulamak için rezervasyon sunucunuza düzenli olarak çağrı gönderir.

Sunucunuzun yayın durumunu belirtmek için HTTP durum kodunu kullanın. Sunucu etkinse ve başarıyla çalışıyorsa HTTP durum kodu 200'ü döndürün.

Bir hatayı belirtmek veya entegrasyonunuzu geçici olarak devre dışı bırakmak için uygun 2xx dışı HTTP durum kodunu döndürün.

 GET /v3/HealthCheck/

Korumalı alan rezervasyon akışı

Sandbox rezervasyon akışını görüntülemek için İşlemler Merkezi'ndeki Envanter görünümüne gidin. Envanter görünümünün RwG - E2E sütununda, eşleşen ve gelecekteki kullanılabilirliği olan Sandbox satıcıları için Sandbox rezervasyon akışına yönelik bir Canlı (Sandbox'ta) bağlantısı gösterilir.

Aşağıda rezervasyon akışındaki işlemler verilmiştir:

  • RwG - E2E bağlantısını tıkladığınızda, sayfa yüklenirken bir BatchAvailabilityLookup istek tetiklenir ve satıcının bilinen stok durumu gösterilir.
  • Bir rezervasyon saatini tıkladığınızda BatchAvailabilityLookup on slot click isteği tetiklenir ve rezervasyon modalı gösterilir.
  • CreateBooking isteğini göndermek için rezervasyon modalıyla rezervasyonu tamamlayın.
  • Korumalı alan ortamında bir rezervasyonu tamamladıktan sonra, rezervasyonu oluşturmak için kullanılan hesaba rezervasyon ayrıntılarını içeren bir onay e-postası gönderilir.
  • UpdateBooking yöntemini tetiklemek için rezervasyonu e-postadan değiştirin veya iptal edin.

HealthCheck

HealthCheck yöntemini korumalı alanda ve üretimde uyguladığınızdan emin olun. Bu yöntem, rezervasyon sunucunuzun durumunu döndürür. Google, bu sayede rezervasyon sunucunuzun yayın durumunu sürekli olarak izleyebilir.

İstek: Yok

Döndürülen değer: Yok

Sunucunuzun yayın durumunu belirtmek için HTTP durum kodunu kullanın.

Sunucu etkinse ve başarılı bir şekilde çalışıyorsa HTTP durum kodu 200'ü döndürün. Hata olduğunu belirtmek için ise HTTP durum kodlarından birini döndürün.