REST Resource: inventory.partners.merchants.services.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)
}

string (Timestamp format)

अपॉइंटमेंट स्लॉट शुरू होने का समय.

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

string (Duration format)

अपॉइंटमेंट स्लॉट की अवधि

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

string (int64 format)

इस उपलब्धता के लिए, कुल स्पॉट और उपलब्ध स्पॉट की संख्या. उदाहरण:

• 10 लोगों के लिए योग क्लास, जिसमें से तीन लोगों ने बुक किया है: availability {spotsTotal: 10, spotsOpen: 7 ...}
• चेयर मसाज का ऐसा सेशन जो पहले से पूरी तरह बुक है: availability {spotsTotal: 1, spotsOpen: 0 ...}

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

• बार-बार होने का मतलब है कि spotsTotal=1 और spotsOpen=1.
• ScheduleException का मतलब है कि spotsTotal=1 और spotsOpen=0.

string (int64 format)

खाली जगहों की संख्या.

string

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

object (Resources)

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

उदाहरण के लिए, एक ही योग क्लास में दो ट्रेनर:

availability { resources { staffId: "1" staffName: "Amy" }
               spotsTotal: 10 spotsOpen: 7 }
availability { resources { staffId: "2" staffName: "John" }
               spotsTotal: 5 spotsOpen: 2 }

string

पेमेंट के उन विकल्पों के आईडी की सूची जिनका इस्तेमाल इस स्लॉट के लिए पेमेंट करने के लिए किया जा सकता है. पेमेंट के असल विकल्प, कारोबारी या कंपनी के लेवल पर तय किए जाते हैं. साथ ही, इन्हें कई कारोबारियों या कंपनियों के बीच शेयर भी किया जा सकता है.

यह फ़ील्ड, सेवा मैसेज में बताए गए किसी भी payment_option_ids को बदल देता है. इसी तरह, यहां बताए गए payment_option_ids को सेवा मैसेज में शामिल करना ज़रूरी नहीं है. हालांकि, इन्हें व्यापारी/कंपनी/कारोबारी के लेवल पर तय करना ज़रूरी है.

object (Recurrence)

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

object (ScheduleException)

वे समय जब इस सेवा को शेड्यूल नहीं किया जा सकता. scheduleException मैसेज की संख्या को सीमित करने के लिए, आस-पास के अपवादों को जोड़ें.

object (Deposit)

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

object (NoShowFee)

बुकिंग न करने पर लगने वाला शुल्क, बुकिंग के लिए उपलब्धता के इस विकल्प के लिए ज़रूरी नहीं है. अगर बुकिंग के लिए कोई शुल्क तय किया गया है, तो यह शुल्क लागू नहीं होगा.

object (Prepayment)

ज़रूरी नहीं. इस अवधि के लिए, पहले से पैसे चुकाने की जानकारी. यह जानकारी देना ज़रूरी नहीं है.

enum (RequireCreditCard)

इससे पता चलता है कि उपलब्धता के इस स्लॉट को बुक करने के लिए, उपयोगकर्ता को क्रेडिट कार्ड की जानकारी देनी होगी या नहीं. अगर वैल्यू सेट नहीं की गई है, तो इसे सेवा लेवल से इनहेरिट किया जाता है. हालांकि, इसके लिए ज़रूरी है कि सेवा लेवल पर वैल्यू सेट की गई हो. (ज़रूरी नहीं)

string

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

• चार तरह के टिकट वाली सेवा: TicketType {ticketTypeId: "adult_1" shortDescription: "Adult weekdays"} TicketType {ticketTypeId: "adult_2" shortDescription: "Adult weekends"} TicketType {ticketTypeId: "youth_1" shortDescription: "Youth weekdays"} TicketType {ticketTypeId: "youth_2" shortDescription: "Youth weekends"}

हफ़्ते के दिनों में इन्वेंट्री दिखाने के लिए: availability {ticketTypeId: "adult_1" ticketTypeId: "youth_1"...}. छुट्टियों के दौरान इन्वेंट्री दिखाने के लिए: availability {ticketTypeId: "adult_2" ticketTypeId: "youth_2"...}.

• तीन तरह के टिकट वाली सेवा: TicketType {ticketTypeId: "adult" shortDescription: "Adult"} TicketType {ticketTypeId: "youth" shortDescription: "Youth"} TicketType {ticketTypeId: "senior" shortDescription: "Senior"}

इस टाइम स्लॉट के लिए, टिकट के तीनों टाइप उपलब्ध हैं, यह बताने के लिए availability {ticketTypeId: "adult" ticketTypeId: "youth" ticketTypeId: "senior" ...} या `availability {...}' में से किसी एक का इस्तेमाल करें. इस स्लॉट में ticketTypeId सेट न करें.

(ज़रूरी नहीं)

enum (DurationRequirement)

स्लॉट की अवधि और/या खत्म होने का समय दिखाने की ज़रूरत. अगर स्लॉट उपलब्ध नहीं है, तो इस फ़ील्ड को अनदेखा कर दिया जाएगा. इसका इस्तेमाल 'क्या-क्या करें' वर्टिकल में नहीं किया जाता. (ज़रूरी नहीं)

object (SchedulingRuleOverrides)

उपलब्धता शेड्यूल करने के नियम. अगर फ़ील्ड अपने-आप पॉप्युलेट होते हैं, तो वे सेवा-लेवल के SchedulingRules पर मौजूद, शेड्यूलिंग से जुड़े किसी भी नियम को बदल देंगे.

enum (ConfirmationMode)

पुष्टि करने का वह तरीका जिसका इस्तेमाल, इस उपलब्धता को बुक करते समय किया जाएगा. CONFIRMATION_MODE_SYNCHRONOUS के पुष्टि मोड के साथ, उपलब्धता के लिए बुकिंग करने की कोशिशों की तुरंत पुष्टि या अस्वीकार कर दिया जाना चाहिए. CONFIRMATION_MODE_ASYNCHRONOUS के पुष्टि मोड के साथ, उपलब्धता के लिए बुकिंग बनाने की कोशिशों को तुरंत अस्वीकार कर दिया जाना चाहिए या स्थिति 'मंज़ूरी बाकी है' के साथ बनाया जाना चाहिए.

enum (LinkoutRequiredReason)

ज़रूरी नहीं. इस स्लॉट के लिए लिंकआउट की ज़रूरत क्यों है. अगर यह सेट है, तो इस स्लॉट के लिए व्यापारी/कंपनी/कारोबारी के रिसॉर्स में एक मान्य LinkoutTemplate होना चाहिए. (ज़रूरी नहीं)

{
  "staffId": string,
  "staffName": string,
  "roomId": string,
  "roomName": string,
  "partySize": integer,
  "roomDescription": {
    object (Text)
  }
}

string

सेवा देने वाले स्टाफ़ सदस्य का आईडी. हालांकि, यह डालना ज़रूरी नहीं है. इस फ़ील्ड से, सभी कारोबारियों/कंपनियों/कारोबारियों, सेवाओं, और उपलब्धता के रिकॉर्ड में मौजूद स्टाफ़ सदस्य की पहचान की जाती है. साथ ही, यह समय के साथ स्थिर भी होना चाहिए, ताकि पिछली बुकिंग के साथ इसका मिलान किया जा सके. अगर staffName मौजूद है, तो यह फ़ील्ड भी मौजूद होना चाहिए.

string

सेवा देने वाले स्टाफ़ सदस्य का नाम. यह नाम देना ज़रूरी नहीं है. यह फ़ील्ड, बुकिंग करने वाले उपयोगकर्ताओं को दिखेगा. साथ ही, यह ऐसा होना चाहिए जिसे कोई भी व्यक्ति पढ़ सके. अगर staffId मौजूद है, तो यह फ़ील्ड भी मौजूद होना चाहिए.

string

उस कमरे का आईडी जहां यह सेवा उपलब्ध है. हालांकि, यह आईडी देना ज़रूरी नहीं है. इस फ़ील्ड से, सभी कारोबारियों/कंपनियों/कारोबारियों के संगठनों, सेवाओं, और उपलब्धता के रिकॉर्ड में मौजूद कमरे की पहचान की जाती है. साथ ही, यह समय के साथ स्थिर भी होना चाहिए, ताकि पिछली बुकिंग के साथ इसका मिलान किया जा सके. अगर roomName मौजूद है, तो यह फ़ील्ड भी मौजूद होना चाहिए.

string

इस रूम में मौजूद सेवा के लिए कोई नाम. यह नाम देना ज़रूरी नहीं है. यह फ़ील्ड, बुकिंग करने वाले उपयोगकर्ताओं को दिखेगा. साथ ही, यह ऐसा होना चाहिए जिसे कोई भी व्यक्ति पढ़ सके. (ज़रूरी नहीं, लेकिन अगर roomId मौजूद है, तो ज़रूरी है) डाइनिंग में, रूम के नाम का इस्तेमाल सिर्फ़ बार या पैटिओ जैसे बैठने की जगहों के लिए किया जाना चाहिए. इसका इस्तेमाल, तय कीमत वाले मेन्यू, खास गतिविधियों या रूम से जुड़ी किसी अन्य वैल्यू (जैसे, बुकिंग या डिनर) के लिए नहीं किया जाना चाहिए. हमारा सुझाव है कि डिफ़ॉल्ट रूप से बैठने की जगह के साथ कोई रूम न जोड़ा जाए.

integer

सिर्फ़ खाने-पीने के लिए बुकिंग करने पर लागू: इस टाइम स्लॉट के दौरान, पार्टी में शामिल होने वाले लोगों की संख्या. एक रेस्टोरेंट को एक ही समय के लिए कई स्लॉट से जोड़ा जा सकता है. हर स्लॉट में, पार्टी के साइज़ की जानकारी अलग-अलग दी जा सकती है. उदाहरण के लिए, अगर बुकिंग के साथ दो, तीन या चार लोगों को बैठाया जा सकता है.

object (Text)

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

{
  "repeatUntil": string,
  "repeatEvery": string
}

string (Timestamp format)

यूटीसी टाइमस्टैंप, जब तक कि उपलब्धता दोहराई जाती है.

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

string (Duration format)

यह उपलब्धता के एक स्लॉट के बाद अगले स्लॉट के बीच का समय तय करता है.

उदाहरण: अगर किसी शो के लिए उपलब्धता की अवधि 20 मिनट, हर 30 मिनट के बाद दोहराए जाने की अवधि, सुबह 9:00 बजे, और दोहराए जाने की आखिरी तारीख सुबह 11:00 बजे है, तो उसके लिए सुबह 9 से 9:20 बजे, सुबह 9:30 से 9:50 बजे, सुबह 10 से 10:20 बजे, सुबह 10:30 से 10:50 बजे, और सुबह 11 से 11:20 बजे के स्लॉट मिलेंगे. (ज़रूरी)

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

{
  "timeRange": {
    object (TimeRange)
  }
}

object (TimeRange)

अपवाद की समयसीमा. अगर बार-बार होने वाले अपॉइंटमेंट के लिए तय किए गए स्लॉट, कारोबार के बंद होने और खुलने के समय से ओवरलैप होते हैं, तो उन्हें उपलब्ध नहीं माना जाएगा.

उदाहरण: अगर बार-बार होने वाली मीटिंग के लिए, समयसीमा 20 मिनट, हर 30 मिनट में दोहराएं, शुरू होने का समय सुबह 9:00 बजे, और दोहराए जाने की समयसीमा सुबह 11:00 बजे तक है, तो ScheduleException की timeRange सुबह 9:45 बजे से सुबह 11:00 बजे तक होने पर, सुबह 9:30 बजे से 9:50 बजे, सुबह 10 बजे से 10:20 बजे, और सुबह 10:30 बजे से 10:50 बजे के स्लॉट उपलब्ध नहीं होंगे.

ध्यान दें कि समयसीमा 'बंद है' से 'खुला है' है. इसलिए, सुबह 11 बजे से शुरू होने वाले स्लॉट पर कोई असर नहीं पड़ेगा.

{
  "priceInfo": {
    object (PriceInfo)
  }
}

object (PriceInfo)

कीमत की जानकारी के लिए कंटेनर.

{
  "priceType": enum (PriceType),

  // Union field price_options can be only one of the following:
  "price": {
    object (Price)
  },
  "priceRange": {
    object (PriceRange)
  }
  // End of list of possible types for union field price_options.
}

enum (PriceType)

इससे यह तय होता है कि कीमत या कीमत की सीमा (हर व्यक्ति के हिसाब से या तय की गई) कैसे लागू की जाती है

object (Price)

किसी सेवा या शुल्क की कीमत.

object (PriceRange)

किसी सेवा या शुल्क की ऊपरी और/या निचली सीमा.

{
  "minPrice": {
    object (Price)
  },
  "maxPrice": {
    object (Price)
  }
}

object (Price)

कम से कम रकम.

object (Price)

ज़्यादा से ज़्यादा रकम. यह वैल्यू हमेशा minPrice से ज़्यादा होनी चाहिए.

{
  "lastBookableSec": string,
  "firstBookableSec": string,
  "lastOnlineCancellableSec": string
}

string (int64 format)

यह स्लॉट पिछली बार कब बुक किया गया था (सेकंड में). यह टाइमस्टैंप, स्लॉट के startSec से पहले होना चाहिए. अगर उपयोगकर्ताओं को शुरू होने के समय के बाद बुकिंग करनी है, तो सेवा के लेवल पर SchedulingRules.min_booking_before_end_time का इस्तेमाल करें. अगर यह मौजूद है, तो इसकी वैल्यू, उस सेवा के SchedulingRules के min_booking_buffer में बताई गई किसी भी वैल्यू को बदल देगी.

string (int64 format)

इस स्लॉट को बुक करने के लिए, पहली बार (सेकंड में) बुकिंग की गई. यह टाइमस्टैंप, स्लॉट के startSec या lastBookableSec से पहले का होना चाहिए.

string (int64 format)

अगर यह सेट है, तो यह उस समय (यूनिक्स काल से सेकंड में) की जानकारी देता है जब Reserve with Google की मदद से, इस अपॉइंटमेंट स्लॉट को रद्द किया जा सकता है. यह फ़ील्ड, सेवा रद्द करने से जुड़े सभी नियमों को बदल देगा. (ज़रूरी नहीं)