Method: inventory.partners.merchants.services.availability.replace

यह फ़ंक्शन, किसी एग्रीगेटर के ज़रिए मैनेज किए जा रहे व्यापारी/कंपनी/कारोबारी के मौजूदा Service के Availability को बदल देता है और उसे दिखाता है.

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

POST https://mapsbooking.googleapis.com/v1alpha/inventory/{serviceAvailability.name=partners/*/merchants/*/services/*}/availability:replace

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

पाथ पैरामीटर

पैरामीटर
serviceAvailability.name

string

उस सेवा का संसाधन नाम जिस पर इसे लागू करना है. partners/{partner_id}/merchants/{merchantId}/services/{serviceId} फ़ॉर्मैट में

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

अनुरोध के मुख्य भाग में, नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:

JSON के काेड में दिखाना 
{
  "serviceAvailability": {
    "name": string,
    "startTimeRestrict": string,
    "endTimeRestrict": string,
    "durationRestrict": string,
    "resourcesRestrict": {
      "staffId": string,
      "staffName": string,
      "roomId": string,
      "roomName": string,
      "partySize": integer,
      "roomDescription": {
        object (Text)
      }
    },
    "availability": [
      {
        "startTime": string,
        "duration": string,
        "spotsTotal": string,
        "spotsOpen": string,
        "availabilityTag": string,
        "resources": {
          object (Resources)
        },
        "paymentOptionId": [
          string
        ],
        "recurrence": {
          object (Recurrence)
        },
        "scheduleException": [
          {
            object (ScheduleException)
          }
        ],
        "deposit": {
          object (Deposit)
        },
        "noShowFee": {
          object (NoShowFee)
        },
        "prepayment": {
          object (Prepayment)
        },
        "requireCreditCard": enum (RequireCreditCard),
        "ticketTypeId": [
          string
        ],
        "durationRequirement": enum (DurationRequirement),
        "schedulingRuleOverrides": {
          object (SchedulingRuleOverrides)
        },
        "confirmationMode": enum (ConfirmationMode),
        "linkoutRequiredReason": enum (LinkoutRequiredReason)
      }
    ]
  }
}
फ़ील्ड
serviceAvailability.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

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

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

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
serviceAvailability.endTimeRestrict

string (Timestamp format)

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

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
serviceAvailability.durationRestrict

string (Duration format)

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

सेकंड में कुल समय, जिसमें दशमलव के बाद नौ अंक हो सकते हैं. यह समय 's' पर खत्म होता है. उदाहरण: "3.5s".
serviceAvailability.resourcesRestrict

object (Resources)

resourcesRestrict सेट करने पर, अपडेट का दायरा सिर्फ़ संसाधनों के इस सेट तक सीमित हो जाता है. संसाधनों के सभी आईडी फ़ील्ड एक जैसे होने चाहिए.
serviceAvailability.availability[]

object (Availability)

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

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

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

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

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

string

उस सेवा का संसाधन नाम जिस पर इसे लागू करना है. partners/{partner_id}/merchants/{merchantId}/services/{serviceId} फ़ॉर्मैट में
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

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

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

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
endTimeRestrict

string (Timestamp format)

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

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
durationRestrict

string (Duration format)

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

सेकंड में कुल समय, जिसमें दशमलव के बाद नौ अंक हो सकते हैं. यह समय 's' पर खत्म होता है. उदाहरण: "3.5s".
resourcesRestrict

object (Resources)

resourcesRestrict सेट करने पर, अपडेट का दायरा सिर्फ़ संसाधनों के इस सेट तक सीमित हो जाता है. संसाधनों के सभी आईडी फ़ील्ड एक जैसे होने चाहिए.
availability[]

object (Availability)

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

अनुमति के दायरे

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

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