- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- BookingFailure
- Cause
- PaymentFailureInformation
- ThreeDS1Parameters
मौजूदा Booking
को अपडेट करता है.
एचटीटीपी अनुरोध
PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{booking.name=partners/*/bookings/*}
यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
booking.name |
बुकिंग के संसाधन का नाम: |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
updateMask |
बुकिंग के सभी फ़ील्ड का फ़ील्ड मास्क अपडेट करना है यह फ़ील्ड के पूरी तरह क्वालिफ़ाइड नामों की कॉमा-सेपरेटेड लिस्ट है. उदाहरण: |
bookingFailure |
अगर एसिंक्रोनस तरीके से पुष्टि किए गए बुकिंग अनुरोध की प्रोसेस फ़ेल हो जाती है और बुकिंग की स्थिति को अपडेट नहीं किया जा रहा होता है, तो इस फ़ील्ड में कारोबारी नियम से जुड़ी गड़बड़ी दिखनी चाहिए. उदाहरण के लिए, उपयोगकर्ता के पास इस समय के बहुत पास की बुकिंग है. इस फ़ील्ड को सिर्फ़ तब सेट करना चाहिए, जब बुकिंग की स्थिति को 'पूरी नहीं हो सकी' पर अपडेट किया जा रहा हो. ऐसा न करने पर, इसे अनदेखा कर दिया जाएगा. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में Booking
का उदाहरण है.
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में Booking
का एक इंस्टेंस शामिल किया जाता है.
अनुमति पाने के लिंक
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/mapsbooking
BookingFailure
स्थिति का डेटा, जो यह बताता है कि बुकिंग की प्रोसेसिंग एसिंक्रोनस क्यों नहीं हो पाई. BookingFailure का मकसद मुख्य तौर पर कारोबार के लॉजिक से जुड़ी गड़बड़ियों को कैप्चर करना है.
जेएसओएन के काेड में दिखाना |
---|
{ "cause": enum ( |
फ़ील्ड | |
---|---|
cause |
बुकिंग न हो पाने की वजह. (ज़रूरी) |
rejectedCardType |
(सिर्फ़ तब ज़रूरी है, जब वजह PAYMENT_ERROR_CARD_TYPE_REJECTED हो) |
description |
इस वैकल्पिक फ़ील्ड का इस्तेमाल, पार्टनर के लिए सिर्फ़ डीबग करने के मकसद से ज़्यादा जानकारी शामिल करने के लिए किया जाता है. (ज़रूरी नहीं) |
paymentFailure |
पेमेंट न हो पाने के बारे में जानकारी. |
वजह
सफल न होने की वजहों की गिनती.
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 |
RwG एग्रीगेटर, उपयोगकर्ता के साथ 3DS1 पुष्टि करने का प्रोटोकॉल शुरू करने के लिए इन पैरामीटर का इस्तेमाल करता है. इसे तब तक अनदेखा किया जाएगा, जब तक BookingFailure.cause को PAYMENT_REQUIRES_3DS1 पर सेट नहीं किया गया हो. |
ThreeDS1Parameters
ऐसे पैरामीटर जो RwG से 3DS1 चैलेंज पूरा करने का अनुरोध करते हैं.
पैरामीटर, EMVCo की 3DS1 प्रोटोकॉल जानकारी के आधार पर सेट किए जाते हैं.
जेएसओएन के काेड में दिखाना |
---|
{ "acsUrl": string, "paReq": string, "transactionId": string, "mdMerchantData": string } |
फ़ील्ड | |
---|---|
acsUrl |
वह यूआरएल जिससे पुष्टि करने के मकसद से उपयोगकर्ता को दिखाने के लिए फ़ॉर्म लोड किया जाता है. |
paReq |
पेमेंट की पुष्टि करने का अनुरोध. अगर यह दिया जाता है, तो इसे ACSUrl फ़ॉर्म में पोस्ट करने के लिए. |
transactionId |
एक आइडेंटिफ़ायर जिसका इस्तेमाल ACS सेवा देने वाली कंपनी करती है. अगर यह दिया जाता है, तो इसे ACSUrl फ़ॉर्म में पोस्ट करने के लिए. |
mdMerchantData |
व्यापारी/कंपनी का डेटा. अगर यह दिया जाता है, तो इसे ACSUrl फ़ॉर्म में पोस्ट करने के लिए. |