Method: notification.partners.bookings.patch

मौजूदा Booking को अपडेट करता है.

एचटीटीपी अनुरोध

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

यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
booking.name

string

बुकिंग के संसाधन का नाम: partners/{partner ID}/bookings/{booking ID}

क्वेरी पैरामीटर

पैरामीटर
updateMask

string (FieldMask format)

बुकिंग के सभी फ़ील्ड का फ़ील्ड मास्क अपडेट करना है

यह फ़ील्ड के पूरी तरह क्वालिफ़ाइड नामों की कॉमा-सेपरेटेड लिस्ट है. उदाहरण: "user.displayName,photo".
bookingFailure

object (BookingFailure)

अगर एसिंक्रोनस तरीके से पुष्टि किए गए बुकिंग अनुरोध की प्रोसेस फ़ेल हो जाती है और बुकिंग की स्थिति को अपडेट नहीं किया जा रहा होता है, तो इस फ़ील्ड में कारोबारी नियम से जुड़ी गड़बड़ी दिखनी चाहिए. उदाहरण के लिए, उपयोगकर्ता के पास इस समय के बहुत पास की बुकिंग है. इस फ़ील्ड को सिर्फ़ तब सेट करना चाहिए, जब बुकिंग की स्थिति को 'पूरी नहीं हो सकी' पर अपडेट किया जा रहा हो. ऐसा न करने पर, इसे अनदेखा कर दिया जाएगा.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में Booking का उदाहरण है.

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में Booking का एक इंस्टेंस शामिल किया जाता है.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

BookingFailure

स्थिति का डेटा, जो यह बताता है कि बुकिंग की प्रोसेसिंग एसिंक्रोनस क्यों नहीं हो पाई. BookingFailure का मकसद मुख्य तौर पर कारोबार के लॉजिक से जुड़ी गड़बड़ियों को कैप्चर करना है.

जेएसओएन के काेड में दिखाना 
{
  "cause": enum (Cause),
  "rejectedCardType": enum (CreditCardType),
  "description": string,
  "paymentFailure": {
    object (PaymentFailureInformation)
  }
}
फ़ील्ड
cause

enum (Cause)

बुकिंग न हो पाने की वजह. (ज़रूरी)
rejectedCardType

enum (CreditCardType)

(सिर्फ़ तब ज़रूरी है, जब वजह PAYMENT_ERROR_CARD_TYPE_REJECTED हो)
description

string

इस वैकल्पिक फ़ील्ड का इस्तेमाल, पार्टनर के लिए सिर्फ़ डीबग करने के मकसद से ज़्यादा जानकारी शामिल करने के लिए किया जाता है. (ज़रूरी नहीं)
paymentFailure

object (PaymentFailureInformation)

पेमेंट न हो पाने के बारे में जानकारी.

वजह

सफल न होने की वजहों की गिनती.

Enums
CAUSE_UNSPECIFIED डिफ़ॉल्ट वैल्यू: इसका इस्तेमाल न करें, जो "अज्ञात गड़बड़ी" के बराबर है
SLOT_UNAVAILABLE रेफ़र किया गया उपलब्धता स्लॉट अब उपलब्ध नहीं है.
SLOT_ALREADY_BOOKED_BY_USER उपयोगकर्ता ने रेफ़रंस के लिए उपलब्ध उपलब्धता स्लॉट के लिए, पहले ही अपॉइंटमेंट बुक कर लिया है.
LEASE_EXPIRED लीज़ की समयसीमा खत्म हो गई है. अनुरोध की गई बुकिंग को पूरा करने के लिए, अब इसका इस्तेमाल नहीं किया जा सकता.
OUTSIDE_CANCELLATION_WINDOW कारोबारी की रद्द करने की नीति में समय से जुड़ी पाबंदियों की वजह से, अनुरोध रद्द करने का अनुरोध फ़िलहाल नहीं किया जा सकता.
PAYMENT_ERROR_CARD_TYPE_REJECTED पेमेंट प्रोसेस करते समय कोई गड़बड़ी हुई, क्योंकि दिया गया क्रेडिट कार्ड का टाइप, कारोबारी ने स्वीकार नहीं किया. क्रेडिट कार्ड के इस तरह के पते की जानकारी, खाली कार्डटाइप में दी जानी चाहिए.
PAYMENT_ERROR_CARD_DECLINED दिया गया क्रेडिट कार्ड अस्वीकार कर दिए जाने की वजह से, पेमेंट प्रोसेस करते समय कोई गड़बड़ी हुई.
PAYMENT_OPTION_NOT_VALID बुकिंग का पेमेंट करने के लिए इस्तेमाल किए गए पैक/सदस्यता में कोई गड़बड़ी हुई. शायद कोई मान्य इस्तेमाल बचा नहीं है, इसकी समयसीमा खत्म हो चुकी है वगैरह.
PAYMENT_ERROR इस बुकिंग के लिए पेमेंट प्रोसेस करते समय कोई गड़बड़ी हुई. इस वैल्यू का इस्तेमाल पेमेंट से जुड़ी सामान्य गड़बड़ी को दिखाने के लिए करें. ऐसा सिर्फ़ तब करें, जब यह गड़बड़ी ऊपर दी गई पेमेंट की किसी गड़बड़ी से मेल न खाती हो.
USER_CANNOT_USE_PAYMENT_OPTION उपयोगकर्ता दिए गए पैसे चुकाने के विकल्प का इस्तेमाल नहीं कर सकता (उदाहरण के लिए, उपयोगकर्ता दूसरी बार पहली बार कीमत इस्तेमाल करने की कोशिश कर रहा है).
BOOKING_ALREADY_CANCELLED उपयोगकर्ता ने जिस बुकिंग को रद्द करने की कोशिश की थी उसे पहले ही रद्द कर दिया गया है.
BOOKING_NOT_CANCELLABLE उपयोगकर्ता ने जिस बुकिंग को रद्द करने की कोशिश की है उसे रद्द नहीं किया जा सकता.
OVERLAPPING_RESERVATION उपयोगकर्ता का एक मौजूदा आरक्षण इस समय के बहुत पास है.
USER_OVER_BOOKING_LIMIT उपयोगकर्ता की बुकिंग करने की सीमा, हर उपयोगकर्ता के लिए एग्रीगेटर की तय सीमा से ज़्यादा है. इस वजह से, बुकिंग नहीं की जा सकी.
PAYMENT_REQUIRES_3DS1

पेमेंट अस्वीकार होने की स्थिति सेट करें, क्योंकि आपने लेन-देन को फिर से आज़माने का अनुरोध किया है. इस बार, 3DS1 चैलेंज/रिस्पॉन्स को पूरा करने के बाद ऐसा करें. ध्यान दें कि लेन-देन पूरा न हो पाने की मौजूदा स्थिति बनी रहेगी. फिर से कोशिश करने का विकल्प पूरी तरह से अलग होगा.

अगर ऐसा नहीं हो पाता है, तो paymentFailure.3DS1_parameters सेट करना ज़रूरी है. अगर ऐसा नहीं है, तो मौजूदा वजह को PAYMENT_ERROR माना जाएगा.

PaymentFailureInformation

पेमेंट न हो पाने के बारे में जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "threeds1Parameters": {
    object (ThreeDS1Parameters)
  }
}
फ़ील्ड
threeds1Parameters

object (ThreeDS1Parameters)

RwG एग्रीगेटर, उपयोगकर्ता के साथ 3DS1 पुष्टि करने का प्रोटोकॉल शुरू करने के लिए इन पैरामीटर का इस्तेमाल करता है. इसे तब तक अनदेखा किया जाएगा, जब तक BookingFailure.cause को PAYMENT_REQUIRES_3DS1 पर सेट नहीं किया गया हो.

ThreeDS1Parameters

ऐसे पैरामीटर जो RwG से 3DS1 चैलेंज पूरा करने का अनुरोध करते हैं.

पैरामीटर, EMVCo की 3DS1 प्रोटोकॉल जानकारी के आधार पर सेट किए जाते हैं.

जेएसओएन के काेड में दिखाना 
{
  "acsUrl": string,
  "paReq": string,
  "transactionId": string,
  "mdMerchantData": string
}
फ़ील्ड
acsUrl

string

वह यूआरएल जिससे पुष्टि करने के मकसद से उपयोगकर्ता को दिखाने के लिए फ़ॉर्म लोड किया जाता है.
paReq

string

पेमेंट की पुष्टि करने का अनुरोध. अगर यह दिया जाता है, तो इसे ACSUrl फ़ॉर्म में पोस्ट करने के लिए.
transactionId

string

एक आइडेंटिफ़ायर जिसका इस्तेमाल ACS सेवा देने वाली कंपनी करती है. अगर यह दिया जाता है, तो इसे ACSUrl फ़ॉर्म में पोस्ट करने के लिए.
mdMerchantData

string

व्यापारी/कंपनी का डेटा. अगर यह दिया जाता है, तो इसे ACSUrl फ़ॉर्म में पोस्ट करने के लिए.