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 का मकसद, मुख्य रूप से कारोबारी लॉजिक से जुड़ी गड़बड़ियों को कैप्चर करना है.

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

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

ThreeDS1Parameters

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

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

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

string

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

string

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

string

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

string

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