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

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

JSON के काेड में दिखाना 
{
  "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 पेमेंट प्रोसेस करते समय गड़बड़ी हुई, क्योंकि व्यापारी/कंपनी ने इस तरह के क्रेडिट कार्ड को स्वीकार नहीं किया. क्रेडिट कार्ड के प्रकार की आपूर्ति अस्वीकार किए गएCardType में की जानी चाहिए.
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

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

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

object (ThreeDS1Parameters)

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

ThreeDS1Parameters

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

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

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

string

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

string

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

string

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

string

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