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

यह स्टेटस डेटा बताता है कि बुकिंग को एसिंक्रोनस तरीके से प्रोसेस क्यों नहीं किया जा सका. 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)

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

ThreeDS1Parameters

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

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

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

string

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

string

PaymentAuthenticationRequest. अगर ACSUrl फ़ॉर्म दिया गया है, तो उसे पोस्ट किया जाएगा.
transactionId

string

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

string

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