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 saate ç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

Rezervasyonun işlenmesinin neden eşzamansız olarak başarısız olduğunu açıklayan durum verileri. ReservationFailure, ö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 olma nedeni. (zorunlu)

rejectedCardType

enum (CreditCardType)

(yalnızca neden PAYMENT_ERROR_CARD_TYPE_REJECTED ise gerekli)

description

string

Bu isteğe bağlı alan, iş ortağının yalnızca hata ayıklama amacıyla ek bilgiler içermesi 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: Kullanmayın; "bilinmeyen hata" anlamına gelir
SLOT_UNAVAILABLE Referans verilen müsaitlik durumu alanı artık kullanılamıyor.
SLOT_ALREADY_BOOKED_BY_USER Kullanıcı, belirtilen müsaitlik durumu aralığı için zaten randevu aldı.
LEASE_EXPIRED Kontratın (sağlanmışsa) süresi doldu ve artık istenen rezervasyonu tamamlamak için 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 Belirtilen kredi kartı türü satıcı tarafından kabul edilmediği için ödeme işlenirken bir hatayla karşılaşıldı. Kredi kartı türü, reddedildiğicardType olarak sağlanmalıdır.
PAYMENT_ERROR_CARD_DECLINED Sağlanan kredi kartı reddedildiği için ö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 hata oluştu. Geçerli kullanım kalmamış olabilir, süresi dolmuş olabilir vb.
PAYMENT_ERROR Bu rezervasyonun ödemesi işlenirken bir hatayla karşılaşıldı. Ödemeyle ilgili genel bir hatayı belirtmek için bu değeri kullanın (yalnızca hatanın yukarıdaki belirli bir ödeme hatasıyla eşleşmemesi durumunda).
USER_CANNOT_USE_PAYMENT_OPTION Kullanıcı, belirtilen ödeme seçeneğini kullanamıyor (ör. ilk fiyatı ikinci kez kullanmaya çalışan kullanıcı).
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ığı rezervasyonlar iptal edilemez.
OVERLAPPING_RESERVATION Kullanıcının bu saate çok yakın tarihli bir rezervasyonu var.
USER_OVER_BOOKING_LIMIT Kullanıcının, toplayıcının kullanıcı başına rezervasyon sınırını aşması nedeniyle rezervasyon yapılamadı.
PAYMENT_REQUIRES_3DS1

İşlemin tekrar denenmesini istediğiniz için ödemenin reddedildiği zamanı ayarlayın, ancak bu kez 3DS1 sorgulaması/yanıtı geçtikten sonra. Geçerli işlemin başarısız durumunun başarısız olarak kalacağını unutmayın. Yeniden deneme tamamen ayrı olacaktır.

Başarısızlık nedeni buysa paymentFailure.3DS1_parameters ayarlanması ZORUNLUDUR. Aksi takdirde, mevcut neden PAYMENT_ERROR' olarak değerlendirilecektir.

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ü başlatmak için kullanılan parametreler. ReservationFailure.cause PAYMENT_REQUIRES_3DS1 olarak ayarlanmadığı sürece yoksayılır.

ThreeDS1Parameters

RwG'yi isteyen parametreler, bir 3DS1 testi gerçekleştirebilir.

Parametreler, EMVCo'nun 3DS1 protokolüyle ilgili açıklaması tarafından 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 formun yükleneceği URL.

paReq

string

Ödeme Kimlik Doğrulaması İsteği. Sağlanırsa ACSUrl formunda yayınlanacaktır.

transactionId

string

ACS sağlayıcısı tarafından kullanılan tanımlayıcı. Sağlanırsa ACSUrl formunda yayınlanacaktır.

mdMerchantData

string

Satıcı verileri. Sağlanırsa ACSUrl formunda yayınlanacaktır.