Method: notification.partners.bookings.patch

Mevcut bir Booking öğesini günceller.

HTTP isteği

PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{booking.name=partners/*/bookings/*}

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
booking.name

string

Rezervasyonun kaynak adı: partners/{partner ID}/bookings/{booking ID}

Sorgu parametreleri

Parametreler
updateMask

string (FieldMask format)

Güncellenecek tüm rezervasyon alanlarının alan maskesi

Bu, alanların tam nitelikli adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo".
bookingFailure

object (BookingFailure)

Asenkron olarak onaylanan bir rezervasyon isteği işlenemezse ve rezervasyonun durumu FAILED olarak güncellenirse bu alan, iş mantığı hatasını yansıtır (ör. kullanıcının bu saate çok yakın bir rezervasyonu vardır). Bu alan yalnızca rezervasyon durumu FAILED olarak güncellenirken ayarlanmalıdır. Aksi takdirde yoksayılır.

İstek içeriği

İstek metni, Booking öğesinin bir örneğini içerir.

Yanıt gövdesi

Başarılıysa yanıt metni, Booking öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/mapsbooking

BookingFailure

Bir rezervasyonun işlenmesinin neden eşzamansız olarak başarısız olduğunu belirten durum verileri. BookingFailure, öncelikle iş mantığı hatalarını yakalamak için tasarlanmıştır.

JSON gösterimi 
{
  "cause": enum (Cause),
  "rejectedCardType": enum (CreditCardType),
  "description": string,
  "paymentFailure": {
    object (PaymentFailureInformation)
  }
}
Alanlar
cause

enum (Cause)

Rezervasyonun başarısız olmasının nedeni. (gerekli)
rejectedCardType

enum (CreditCardType)

(Yalnızca neden PAYMENT_ERROR_CARD_TYPE_REJECTED ise gereklidir.)
description

string

Bu isteğe bağlı alan, iş ortağının yalnızca hata ayıklama amacıyla ek bilgiler dahil etmesi için kullanılır. (isteğe bağlı)
paymentFailure

object (PaymentFailureInformation)

Ödeme hataları hakkında bilgi.

Neden

Başarısızlık nedenlerinin listesi.

Sıralamalar
CAUSE_UNSPECIFIED Varsayılan değer: Kullanmayın; "bilinmeyen hata" anlamına gelir
SLOT_UNAVAILABLE Referans verilen kullanılabilirlik aralığı artık kullanılamıyor.
SLOT_ALREADY_BOOKED_BY_USER Kullanıcı, referans verilen müsaitlik durumu aralığı için zaten randevu aldı.
LEASE_EXPIRED Kiralama (varsa) süresinin dolması ve istenen rezervasyonu tamamlamak için artık kullanılamaması.
OUTSIDE_CANCELLATION_WINDOW İstenen iptal işlemi, satıcının iptal politikasındaki zaman kısıtlamaları nedeniyle şu anda gerçekleştirilemiyor.
PAYMENT_ERROR_CARD_TYPE_REJECTED Sağlanan kredi kartı türü satıcı tarafından kabul edilmediğinden ödeme işlenirken bir hatayla karşılaşıldı. Kredi kartı türü, rejectedCardType parametresinde sağlanmalıdır.
PAYMENT_ERROR_CARD_DECLINED Sağlanan kredi kartı reddedildiği için ödeme işlenirken bir hata oluştu.
PAYMENT_OPTION_NOT_VALID Rezervasyon için ödeme yaparken kullanılan paket/üyelik ile ilgili bir hata oluştu. Kullanım hakkınız kalmamış veya süre dolabilir.
PAYMENT_ERROR Bu rezervasyon için ödeme işlenirken bir hatayla karşılaşıldı. Yalnızca hata yukarıdaki belirli bir ödeme hatasıyla eşleşmezse ödemeyle ilgili genel bir hatayı belirtmek için bu değeri kullanın.
USER_CANNOT_USE_PAYMENT_OPTION Kullanıcı, belirtilen ödeme seçeneğini kullanamıyordur (ör. kullanıcı, ilk kez sunulan fiyatı ikinci kez kullanmaya çalışıyordur).
BOOKING_ALREADY_CANCELLED Kullanıcının iptal etmeye çalıştığı bir rezervasyon zaten iptal edilmiş.
BOOKING_NOT_CANCELLABLE Kullanıcının iptal etmeye çalıştığı rezervasyon iptal edilemez.
OVERLAPPING_RESERVATION Kullanıcının bu saate çok yakın bir rezervasyonu var.
USER_OVER_BOOKING_LIMIT Kullanıcı, toplayıcının kullanıcı başına rezervasyon sınırını aştığı için rezervasyon yapılamadı.
PAYMENT_REQUIRES_3DS1

İşlemin tekrar denenmesini istediğiniz ancak bu kez 3DS1 sorgulaması/yanıtı tamamlandıktan sonra ödemenin ne zaman reddedileceğini ayarlayın. Mevcut işlemin "başarısız" durumu değişmeyecektir. Bu işlem tamamen ayrı şekilde yapılır.

Hata nedeni bu olduğunda paymentFailure.3DS1_parameters ayarlanmalıdır. Aksi takdirde mevcut neden PAYMENT_ERROR olarak değerlendirilir.

PaymentFailureInformation

Ödeme hataları hakkında bilgi.

JSON gösterimi 
{
  "threeds1Parameters": {
    object (ThreeDS1Parameters)
  }
}
Alanlar
threeds1Parameters

object (ThreeDS1Parameters)

RwG toplayıcısı tarafından, kullanıcıyla bir 3DS1 kimlik doğrulama protokolü başlatmak için kullanılan parametreler. BookingFailure.cause PAYMENT_REQUIRES_3DS1 olarak ayarlanmadığı sürece yoksayılır.

ThreeDS1Parameters

RwG'nin 3DS1 sınaması gerçekleştirmesini isteyen parametreler.

Parametreler, EMVCo'nun 3DS1 protokolü açıklamasıyla belirlenir.

JSON gösterimi 
{
  "acsUrl": string,
  "paReq": string,
  "transactionId": string,
  "mdMerchantData": string
}
Alanlar
acsUrl

string

Kimlik doğrulama için Kullanıcıya sunulacak formun yükleneceği URL.
paReq

string

PaymentAuthentication İsteği. Sağlandıysa ACSUrl formuna gönderilir.
transactionId

string

ACS sağlayıcısı tarafından kullanılan bir tanımlayıcı. Sağlandıysa ACSUrl formuna gönderilir.
mdMerchantData

string

Satıcı verileri. Sağlanması durumunda ACSUrl formunda yayınlanır.