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ış listesidir. Örnek: "user.displayName,photo".
bookingFailure

object (BookingFailure)

Eşzamansız olarak onaylanan bir rezervasyon isteğinin işlenmesi başarısız olursa ve rezervasyonun durumu BAŞARISIZ olarak güncellenirse bu alan, işletme mantığı hatasını (ör. kullanıcının bu zamana çok yakın bir zamanda mevcut bir rezervasyonu var) yansıtmalıdır. Bu alan yalnızca rezervasyon durumu BAŞARISIZ olarak güncellenirken ayarlanmalı, aksi takdirde yoksayılmalıdır.

İstek metni

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

Yanıt metni

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 neden eşzamansız olarak işlenemediğini 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 neden başarısız olduğu. (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 eklemesi için kullanılır. (isteğe bağlı)
paymentFailure

object (PaymentFailureInformation)

Ödeme hataları hakkında bilgi

Neden

Hata nedenlerinin listesi.

Sıralamalar
CAUSE_UNSPECIFIED Varsayılan değer: Kullanılmaz. "Bilinmeyen bir hata"ya eşittir.
SLOT_UNAVAILABLE Başvurulan uygunluk aralığı artık kullanılamıyor.
SLOT_ALREADY_BOOKED_BY_USER Kullanıcı, söz konusu uygunluk aralığı için zaten randevu almış.
LEASE_EXPIRED Kiralama sözleşmesinin (varsa) süresi dolmuştur ve istenen rezervasyonu tamamlamak için artık kullanılamaz.
OUTSIDE_CANCELLATION_WINDOW Satıcının iptal politikasındaki zaman kısıtlamaları nedeniyle, istenen iptal işlemi şu anda gerçekleştirilemiyor.
PAYMENT_ERROR_CARD_TYPE_REJECTED Sağlanan kredi kartı türü satıcı tarafından kabul edilmediği için ödeme işlenirken bir hata oluştu. Kredi kartı türü, rejectedCardType içinde sağlanmalıdır.
PAYMENT_ERROR_CARD_DECLINED Belirtilen kredi kartı reddedildiği için ödeme işlenirken bir hata oluştu.
PAYMENT_OPTION_NOT_VALID Rezervasyonun ödemesi için kullanılan paket/üyelikle ilgili bir hata oluştu. Geçerli kullanım kalmamış olabilir, kuponun geçerlilik süresi dolmuş olabilir vb.
PAYMENT_ERROR Bu rezervasyonun ödemesi işlenirken bir hata oluştu. Bu değeri, yalnızca hata yukarıdaki belirli bir ödeme hatasıyla eşleşmiyorsa genel bir ödemeyle ilgili hatayı belirtmek için kullanın.
USER_CANNOT_USE_PAYMENT_OPTION Kullanıcı, belirtilen ödeme seçeneğini kullanamıyor (ör. kullanıcı, ilk kez sunulan fiyatı ikinci kez kullanmaya çalışıyor).
BOOKING_ALREADY_CANCELLED Kullanıcının iptal etmeye çalıştığı rezervasyon zaten iptal edilmiş.
BOOKING_NOT_CANCELLABLE Kullanıcının iptal etmeye çalıştığı rezervasyon iptal edilemiyor.
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 için ödemenin reddedildiği zamanı ayarlayın. Ancak bu kez 3DS1 doğrulama/yanıtı uygulandıktan sonra denenmesini isteyin. Mevcut işlemin başarısızlık durumunun başarısız olarak kalacağını unutmayın. Yeniden deneme işlemi tamamen ayrıdır.

Bu hata nedeni 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)

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

ThreeDS1Parameters

RwG'nin 3DS1 zorluğu gerçekleştirmesini isteyen parametreler.

Parametreler, EMVCo'nun 3DS1 protokolü açıklamasına göre ayarlanır.

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

string

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

string

PaymentAuthentication Request. Sağlanırsa ACSUrl formuna gönderilir.
transactionId

string

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

string

Satıcı verileri Sağlanırsa ACSUrl formuna gönderilir.