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)

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

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

अनुरोध के मुख्य भाग में 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 फ़ॉर्म पर पोस्ट किया जाना चाहिए.