CreateBooking
Hazır ara hedef görevini tamamlamak için CreateBooking
yöntemini başarıyla oluşturup sunmanız gerekir. Bu yöntem, kullanıcı rezervasyon oluşturmaya çalıştığında çağrılır. Başarılı bir rezervasyon oluşturulursa yanıtta, gelecekteki istekler veya güncellemeler için rezervasyona başvurmak üzere benzersiz bir booking_id
yer alır.
CreateBooking göreviyle ilgili şartlar
- Hata oranı %10'dan düşük olan 10 başarılı
CreateBooking
yanıtı.
CreateBooking ile ilgili temel bilgiler
Kullanıcı bir rezervasyon başlattığında iş ortağı rezervasyon sunucusuna CreateBooking
isteği gönderilir. İsteğe verilen yanıt, başarılı bir rezervasyonu veya rezervasyonun başarısız olduğunu gösterir. Rezervasyon başarısız olursa yanıtta başarısızlığa neden olan işletme mantığı hatası yer almalıdır. Örneğin, yer kullanılamaz hale gelmiş veya aynı kullanıcı tarafından daha önce rezerve edilmiş olabilir.
Bir kullanıcı rezervasyon oluşturduğunda Google, kullanıcının adını, soyadını, telefon numarasını ve e-posta adresini size gönderir. Daha fazla bilgi için Hesap eşleştirme ve oluşturma politikası başlıklı makaleyi inceleyin.
İdempotency
Ağ üzerinden iletişim her zaman güvenilir değildir ve yanıt alınmazsa Google, HTTP isteklerini yeniden deneyebilir. Bu nedenle, durumu değiştiren tüm yöntemler idempotent olmalıdır:
CreateBooking
UpdateBooking
UpdateBooking
hariç her istek mesajı için, isteği benzersiz şekilde tanımlamak üzere idempotentlik jetonları eklenir. Bu, tek bir istek ve iki ayrı istek oluşturma amacıyla yeniden denenmiş bir REST çağrısı ile iki ayrı istek arasında ayrım yapmanızı sağlar. UpdateBooking
için ilgili rezervasyon girişi kimlikleri, bunları benzersiz şekilde tanımlamaya yardımcı olur. Bu nedenle, isteklerine bir idempotentlik jetonu dahil edilmez.
Aşağıda, rezervasyon sunucularının tekil işlem özelliğini nasıl işlediğine dair bazı örnekler verilmiştir:
Başarılı bir
CreateBooking
HTTP yanıtı, oluşturulan rezervasyonu içerir. Bazı durumlarda ödeme, rezervasyon akışının bir parçası olarak işlenir. AynıCreateBookingRequest
, aynıidempotency_token
ile ikinci kez alınırsa aynıCreateBookingResponse
döndürülmelidir. İkinci bir rezervasyon oluşturulmaz ve varsa kullanıcıdan tam olarak bir kez ödeme alınır.
İdempotency koşulu, durumu değiştiren tüm yöntemler için geçerlidir.