Method: inventory.partners.availability.replace

इससे मौजूदा Services का Availability बदल जाता है. इस बैच कॉल में एटॉमिकिटी की गारंटी नहीं दी जाती है. सिर्फ़ उन उपलब्धता स्लॉट की जानकारी वापस भेजी जाएगी जिन्हें अपडेट किया गया है.

एचटीटीपी अनुरोध

POST https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*}/availability:replace

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
parent

string

partners/{partner_id} का फ़ॉर्मैट.

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

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना
{
  "extendedServiceAvailability": [
    {
      object (ExtendedServiceAvailability)
    }
  ]
}
फ़ील्ड
extendedServiceAvailability[]

object (ExtendedServiceAvailability)

सेवा की उपलब्धता की वह बढ़ी हुई समयावधि जिसका इस्तेमाल, उपलब्धता के मौजूदा स्लॉट को बदलने के लिए किया जाता है.

जवाब का मुख्य भाग

एक से ज़्यादा Service की उपलब्धता के स्लॉट बदलने के लिए बैच रिस्पॉन्स. इस मैसेज में सिर्फ़ वे स्लॉट शामिल होंगे जिन्हें अपडेट किया गया है

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON फ़ॉर्मैट में दिखाया गया है
{
  "extendedServiceAvailability": [
    {
      object (ExtendedServiceAvailability)
    }
  ]
}
फ़ील्ड
extendedServiceAvailability[]

object (ExtendedServiceAvailability)

एक्सटेंडेड सेवा की उपलब्धता के वे मैसेज जिन्हें अपडेट कर दिया गया है. इनका इस्तेमाल, उपलब्धता के मौजूदा स्लॉट को बदलने के लिए किया गया था.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/mapsbooking

ExtendedServiceAvailability

उपलब्धता की सूची और यह जानकारी कि इन्हें किस व्यक्ति/समय पर लागू किया जाना चाहिए.

JSON के काेड में दिखाना
{
  "merchantId": string,
  "serviceId": string,
  "startTimeRestrict": string,
  "endTimeRestrict": string,
  "durationRestrict": string,
  "resourcesRestrict": {
    object (Resources)
  },
  "availability": [
    {
      object (Availability)
    }
  ]
}
फ़ील्ड
merchantId

string

यह एक ज़रूरी फ़ील्ड है. इससे यह तय किया जाता है कि यहां दिए गए उपलब्धता के मैसेज किस कारोबारी या कंपनी के हैं.

serviceId

string

यह एक ज़रूरी फ़ील्ड है. इससे यह तय किया जाता है कि नीचे दिए गए उपलब्धता के मैसेज किस सेवा से जुड़े हैं.

startTimeRestrict

string (Timestamp format)

अगर आपने उपलब्धता की जानकारी दी है, तो हम इसे [startTimeRestrict, endTimeRestrict) के बीच की पूरी जानकारी मानेंगे. इसका मतलब है कि अगर यह शर्त पूरी होती है, तो खरीदारी के लिए उपलब्धता की मौजूदा जानकारी मिट जाएगी:

   startTimeRestrict <= availability.start_sec &&
   availability.start_sec < endTimeRestrict

अगर अवधि का मैसेज सेट किया गया है, तो शर्त और सीमित हो जाती है:

  availability.duration == durationRestrict

अगर resourcesRestrict मैसेज सेट किया गया है, तो शर्त को और सीमित कर दिया जाता है:

   availability.resources.staff_id == resourcesRestrict.staff_id &&
   availability.resources.room_id == resourcesRestrict.room_id

आम तौर पर, इन फ़ील्ड का इस्तेमाल किसी तय समयसीमा में उपलब्धता की पूरी जानकारी देने के लिए किया जाता है.

endTimeRestrict को सेट न करते हुए startTimeRestrict को सेट करने का मतलब है कि startTimeRestrict से शुरू होने वाला पूरा समय.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

endTimeRestrict

string (Timestamp format)

startTimeRestrict को सेट न करते हुए endTimeRestrict को सेट करने का मतलब है कि endTimeRestrict तक का पूरा समय.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

durationRestrict

string (Duration format)

अवधि सेट करने से, अपडेट का दायरा और सीमित हो जाता है. इससे सिर्फ़ उस समयावधि के लिए उपलब्धता अपडेट होती है जो अवधि से मेल खाती है.

यह सेकंड में अवधि होती है. इसमें नौ दशमलव अंक तक हो सकते हैं. इसके आखिर में 's' होता है. उदाहरण: "3.5s".

resourcesRestrict

object (Resources)

Setting resources से, अपडेट के स्कोप को सिर्फ़ इस सेट के संसाधनों तक सीमित किया जाता है. संसाधनों के सभी आईडी फ़ील्ड पूरी तरह से मेल खाने चाहिए.

availability[]

object (Availability)

उपलब्धता की नई सूची.