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

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 müsaitlik durumu aralığı artık kullanılamıyor.
SLOT_ALREADY_BOOKED_BY_USER Kullanıcı, referans verilen müsaitlik durumu aralığı için zaten randevu almış.
LEASE_EXPIRED Kiralama (varsa) süresinin dolması ve istenen rezervasyonu tamamlamak için artık kullanılamaması.
OUTSIDE_CANCELLATION_WINDOW Satıcının iptal politikasındaki zaman kısıtlamaları nedeniyle, istenen iptal şu anda yapılamıyor.
PAYMENT_ERROR_CARD_TYPE_REJECTED Sağlanan kredi kartı türü satıcı tarafından kabul edilmediğinden ödeme işlenirken bir hata oluştu. 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 dolmuş olabilir.
PAYMENT_ERROR Bu rezervasyonun ödemesi yapılırken bir hata oluştu. 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ığı 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 için ödeme reddedildiğinde ayarlanır. Ancak bu kez 3DS1 istem/yanıtından sonra. Mevcut işlemin "başarısız" durumu değişmeyecektir. Yeniden deneme tamamen ayrı bir işlemdir.

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 3DS1 kimlik doğrulama protokolü başlatmak için kullanılan parametreler. BookingFailure.cause PAYMENT_REQUIRES_3DS1 olarak ayarlanmazsa yoksayılır.

ThreeDS1Parameters

RwG'nin 3DS1 istemi yapmasını 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 gösterilecek formun yükleneceği URL.
paReq

string

PaymentAuthentication Request. 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ğlandıysa ACSUrl formuna gönderilir.