Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
CreateBookingHazı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.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-07-26 UTC."],[],[],null,["# CreateBooking Ready\n\nTo complete the `CreateBooking` Ready milestone task, you need to successfully\nbuild and deliver the `CreateBooking` method. This method is called when a user\nattempts to create a booking. If a successful booking is created, the response\nincludes a unique `booking_id` to refer to the booking for future requests or\nupdates.\n\nCreateBooking task requirements\n-------------------------------\n\n- 10 successful `CreateBooking` responses with an error rate less than 10%.\n\nCreateBooking basics\n--------------------\n\nWhen a user initiates a booking, a `CreateBooking` request is sent to the\npartner Booking Server. The response to the request indicates either a\nsuccessful booking or booking failure. If there is a booking failure, the\nresponse needs to include the business logic error for failure. For example, the\nslot has become unavailable or the slot has been already booked by the same\nuser.\n\nWhen a user creates a booking, Google sends you the user's given name, surname,\nphone number, and email. For more information, see\n[Account matching and creation policy](/actions-center/verticals/reservations/e2e/policies/platform-policies#account_matching_and_creation_policy).\n| **Note:** Business logic errors must be returned in the `CreateBookingResponse.booking_failure` field, rather than through a non-200 HTTP response code.\n| **Warning:** Booking failures because of the unavailability of the slot are considered `CreateBooking` errors. Your integration can be disabled when there are many `CreateBooking` errors. High error rate for `CreateBooking` availability errors indicate that your `BatchAvailabilityLookup` slot click response doesn't accurately reflect real-time inventory.\n\n### Idempotency\n\nCommunication over the network isn't always reliable, and Google can retry HTTP\nrequests if no response is received. For this reason, all methods that mutate\nstate must be idempotent:\n\n- `CreateBooking`\n- `UpdateBooking`\n\nFor every request message, except `UpdateBooking`, idempotency tokens are\nincluded to uniquely identify the request. This lets you distinguish between a\nretried REST call, with the intent to create a single request and two separate\nrequests. The respective booking entry IDs of the `UpdateBooking` help to\nuniquely identify them, so no idempotency token is included in their requests.\n\nThe following are some examples of how Booking Servers handle idempotency:\n\n- A successful\n [`CreateBooking`](/actions-center/verticals/reservations/e2e/reference/booking-server-api-rest/e2e-methods/createbooking-method)\n HTTP response includes the created booking. In some cases, payment is processed\n as part of the booking flow. If the same `CreateBookingRequest` is received a\n second time with the same `idempotency_token`, the same `CreateBookingResponse`\n must be returned. A second booking isn't created, and\n the user is charged exactly once, if applicable.\n\n | **Note:** If a `CreateBooking` attempt fails and the same request is re-sent, your backend must retry the `CreateBooking` request.\n\nThe idempotency requirement applies to all methods that mutate state."]]
