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, tam nitelikli alan adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo".
bookingFailure

object (BookingFailure)

Eşzamansız olarak onaylanmış bir rezervasyon isteğinin işlenmesi başarısız olursa ve rezervasyonun durumu BAŞARISIZ olarak güncelleniyorsa bu alan, iş mantığı hatasını yansıtmalıdır (ör. kullanıcının mevcut rezervasyonu bu zamana çok yakındır). Bu alan yalnızca rezervasyon durumu BAŞARISIZ 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 eşzamansız olarak işlenmesinin neden başarısız olduğunu açıklayan durum verileri. BookingFailure, öncelikli olarak 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ıyla ilgili bilgiler.

Neden

Hata nedenlerinin listesi.

Sıralamalar
CAUSE_UNSPECIFIED Varsayılan değer: Kullanmayın; "bilinmeyen hata"
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 sözleşmesinin (belirtilmişse) süresi dolduğundan istenen rezervasyonu tamamlamak için artık kullanılamaz.
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ü, reddedilenCardType içinde sağlanmalıdır.
PAYMENT_ERROR_CARD_DECLINED Sağlanan kredi kartı reddedildiğinden ödeme işlenirken bir hatayla karşılaşıldı.
PAYMENT_OPTION_NOT_VALID Rezervasyon için ödeme yapmak üzere kullanılan paket/üyelik ile ilgili bir hatayla karşılaşıldı. Hiç geçerli kullanım kalmamış olabilir, süresi dolmuş olabilir vb.
PAYMENT_ERROR Bu rezervasyon için ödeme işlenirken bir hatayla karşılaşıldı. Bu değeri, yalnızca hata yukarıdaki belirli bir ödeme hatasıyla eşleşmiyorsa ödemeyle ilgili genel bir hatayı belirtmek için kullanın.
USER_CANNOT_USE_PAYMENT_OPTION Kullanıcı belirtilen ödeme seçeneğini kullanamıyor (ör. kullanıcı ikinci kez ilk kez fiyat kullanmaya çalışıyor).
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 başarısız oldu.
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. Geçerli işlemin başarısız durumunun başarısız olarak kalacağını unutmayın. Bu işlem tamamen ayrı şekilde yapılır.

Hatanın nedeni buysa paymentFailure.3DS1_parameters ayarlanması ZORUNLUDUR. Aksi takdirde, geçerli neden PAYMENT_ERROR gibi değerlendirilir.

PaymentFailureInformation

Ödeme hatalarıyla ilgili bilgiler.

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üyle ilgili açıklamasına göre ayarlanır.

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ğlanması durumunda ACSUrl formunda yayınlanır.
transactionId

string

ACS sağlayıcısı tarafından kullanılan bir tanımlayıcı. Sağlanması durumunda ACSUrl formunda yayınlanır.
mdMerchantData

string

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