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

जेएसओएन के काेड में दिखाना 
{
  "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 डिफ़ॉल्ट वैल्यू: इस्तेमाल न करें; रकम की जानकारी (&t) और किसी अज्ञात गड़बड़ी की वजह से हो सकता है;
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 चैलेंज/रिस्पॉन्स आने के बाद, पेमेंट फिर से करने की कोशिश करें. ध्यान दें कि लेन-देन की मौजूदा स्थिति पूरी नहीं हो पाएगी. फिर से कोशिश करने का तरीका पूरी तरह अलग होगा.

अगर ऐसा नहीं होता है, तो payFailure.3DS1_parameters सेट होना ज़रूरी है. अगर नहीं, तो मौजूदा वजह को इस तरह माना जाएगा जैसे वह PAYMENT_ERROR था.

पेमेंट में गड़बड़ी की जानकारी

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

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

object (ThreeDS1Parameters)

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

threeDS1पैरामीटर

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

ये पैरामीटर, EMVCo's के 3DS1 प्रोटोकॉल के विवरण के आधार पर सेट किए जाते हैं.

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

string

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

string

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

string

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

string

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