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

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

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".
serviceAvailability.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".
serviceAvailability.durationRestrict

string (Duration format)

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

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

object (Resources)

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

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

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)

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

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

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

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