- संसाधन: खरीदारी के लिए उपलब्धता
- संसाधन
- बार-बार होने वाली गतिविधि
- ScheduleException
- पेमेंट पहले करना
- PriceInfo
- PriceRange
- DurationRequirement
- SchedulingRuleOverrides
- ConfirmationMode
- LinkoutRequiredReason
- तरीके
संसाधन: खरीदारी के लिए उपलब्धता
कारोबारी/कंपनी/कारोबारी की सेवा की उपलब्धता का स्लॉट, जिसमें समय और स्पॉट की संख्या की जानकारी दी गई हो.
JSON के काेड में दिखाना |
---|
{ "startTime": string, "duration": string, "spotsTotal": string, "spotsOpen": string, "availabilityTag": string, "resources": { object ( |
फ़ील्ड | |
---|---|
start |
अपॉइंटमेंट स्लॉट शुरू होने का समय. आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: |
duration |
अपॉइंटमेंट स्लॉट की अवधि सेकंड में कुल समय, जिसमें दशमलव के बाद नौ अंक हो सकते हैं. यह समय ' |
spots |
इस उपलब्धता के लिए, कुल स्पॉट और उपलब्ध स्पॉट की संख्या. उदाहरण:
ध्यान दें: अगर उपलब्धता को कंप्रेस करने के लिए, यहां दिए गए फ़ॉर्मैट का इस्तेमाल करके अनुरोध भेजे जाते हैं, तो इन दोनों फ़ील्ड का अनुमान लगाया जाएगा.
|
spots |
खाली जगहों की संख्या. |
availability |
उपलब्धता के इस स्लॉट की पहचान करने के लिए, एक वैकल्पिक ओपेक स्ट्रिंग. अगर यह सेट है, तो इसे उन अनुरोधों में शामिल किया जाएगा जिनमें अपॉइंटमेंट बुक/अपडेट/रद्द किए जाते हैं. |
resources |
ये वैकल्पिक संसाधन हैं. इनका इस्तेमाल, उपलब्धता के इस स्लॉट को दूसरों से अलग करने के लिए किया जाता है. ऐसा तब किया जाता है, जब सेवा में अलग-अलग कर्मचारी या कमरे शामिल हों. उदाहरण के लिए, एक ही योग क्लास में दो ट्रेनर:
|
payment |
पेमेंट के उन विकल्पों के आईडी की सूची जिनका इस्तेमाल इस स्लॉट के लिए पेमेंट करने के लिए किया जा सकता है. पेमेंट के असल विकल्प, कारोबारी या कंपनी के लेवल पर तय किए जाते हैं. साथ ही, इन्हें कई कारोबारियों या कंपनियों के बीच शेयर भी किया जा सकता है. यह फ़ील्ड, सेवा मैसेज में बताए गए किसी भी payment_option_ids को बदल देता है. इसी तरह, यहां बताए गए payment_option_ids को सेवा मैसेज में शामिल करना ज़रूरी नहीं है. हालांकि, इन्हें व्यापारी/कंपनी/कारोबारी के लेवल पर तय करना ज़रूरी है. |
recurrence |
उपलब्धता के लिए, बार-बार होने की जानकारी, जिसमें शुरू होने का एक से ज़्यादा समय दिखाया गया है. बार-बार होने वाले अपॉइंटमेंट में, एक कामकाजी दिन के लिए अपॉइंटमेंट होने चाहिए. |
schedule |
वे समय जब इस सेवा को शेड्यूल नहीं किया जा सकता. scheduleException मैसेज की संख्या को सीमित करने के लिए, आस-पास के अपवादों को जोड़ें. |
deposit |
इस अवधि के लिए, ज़रूरी नहीं है कि आपने जमा दिया हो. अगर सेवा के लिए कोई डिपॉज़िट तय किया गया था, तो यह उसे बदल देता है. |
no |
बुकिंग न करने पर लगने वाला शुल्क, बुकिंग के लिए उपलब्धता के इस विकल्प के लिए ज़रूरी नहीं है. अगर बुकिंग के लिए कोई शुल्क तय किया गया है, तो यह शुल्क लागू नहीं होगा. |
prepayment |
ज़रूरी नहीं. इस अवधि के लिए, पहले से पैसे चुकाने की जानकारी. यह जानकारी देना ज़रूरी नहीं है. |
require |
इससे पता चलता है कि उपलब्धता के इस स्लॉट को बुक करने के लिए, उपयोगकर्ता को क्रेडिट कार्ड की जानकारी देनी होगी या नहीं. अगर वैल्यू सेट नहीं की गई है, तो इसे सेवा लेवल से इनहेरिट किया जाता है. हालांकि, इसके लिए ज़रूरी है कि सेवा लेवल पर वैल्यू सेट की गई हो. (ज़रूरी नहीं) |
ticket |
उपलब्धता के इस स्लॉट के लिए, इस्तेमाल किए जा सकने वाले टिकट टाइप की सूची दिखाता है. अगर यह सेट नहीं है, तो इस स्लॉट के लिए पैरंट सेवा के सभी टिकट टाइप उपलब्ध होते हैं. ध्यान दें कि इस फ़ील्ड की वैल्यू, पैरंट सेवा में तय की जानी चाहिए. उदाहरण:
हफ़्ते के दिनों में इन्वेंट्री दिखाने के लिए:
इस टाइम स्लॉट के लिए, टिकट के तीनों टाइप उपलब्ध हैं, यह बताने के लिए (ज़रूरी नहीं) |
duration |
स्लॉट की अवधि और/या खत्म होने का समय दिखाने की ज़रूरत. अगर स्लॉट उपलब्ध नहीं है, तो इस फ़ील्ड को अनदेखा कर दिया जाएगा. इसका इस्तेमाल 'क्या-क्या करें' वर्टिकल में नहीं किया जाता. (ज़रूरी नहीं) |
scheduling |
उपलब्धता शेड्यूल करने के नियम. अगर फ़ील्ड अपने-आप पॉप्युलेट होते हैं, तो वे सेवा-लेवल के SchedulingRules पर मौजूद, शेड्यूलिंग से जुड़े किसी भी नियम को बदल देंगे. |
confirmation |
पुष्टि करने का वह तरीका जिसका इस्तेमाल, इस उपलब्धता को बुक करते समय किया जाएगा. CONFIRMATION_MODE_SYNCHRONOUS के पुष्टि मोड के साथ, उपलब्धता के लिए बुकिंग करने की कोशिशों की तुरंत पुष्टि या अस्वीकार कर दिया जाना चाहिए. CONFIRMATION_MODE_ASYNCHRONOUS के पुष्टि मोड के साथ, उपलब्धता के लिए बुकिंग बनाने की कोशिशों को तुरंत अस्वीकार कर दिया जाना चाहिए या स्थिति 'मंज़ूरी बाकी है' के साथ बनाया जाना चाहिए. |
linkout |
ज़रूरी नहीं. इस स्लॉट के लिए लिंकआउट की ज़रूरत क्यों है. अगर यह सेट है, तो इस स्लॉट के लिए व्यापारी/कंपनी/कारोबारी के रिसॉर्स में एक मान्य LinkoutTemplate होना चाहिए. (ज़रूरी नहीं) |
संसाधन
जब सेवा में अलग-अलग स्टाफ़ या रूम शामिल होते हैं, तो उपलब्धता स्लॉट को एक-दूसरे से अलग करने के लिए, संसाधन का इस्तेमाल किया जाता है. एक ही सेवा और समयावधि के लिए, अलग-अलग संसाधनों वाले कई स्लॉट एक साथ मौजूद हो सकते हैं.
JSON के काेड में दिखाना |
---|
{
"staffId": string,
"staffName": string,
"roomId": string,
"roomName": string,
"partySize": integer,
"roomDescription": {
object ( |
फ़ील्ड | |
---|---|
staff |
सेवा देने वाले स्टाफ़ सदस्य का आईडी. हालांकि, यह डालना ज़रूरी नहीं है. इस फ़ील्ड से, सभी कारोबारियों/कंपनियों/कारोबारियों, सेवाओं, और उपलब्धता के रिकॉर्ड में मौजूद स्टाफ़ सदस्य की पहचान की जाती है. साथ ही, यह समय के साथ स्थिर भी होना चाहिए, ताकि पिछली बुकिंग के साथ इसका मिलान किया जा सके. अगर staffName मौजूद है, तो यह फ़ील्ड भी मौजूद होना चाहिए. |
staff |
सेवा देने वाले स्टाफ़ सदस्य का नाम. यह नाम देना ज़रूरी नहीं है. यह फ़ील्ड, बुकिंग करने वाले उपयोगकर्ताओं को दिखेगा. साथ ही, यह ऐसा होना चाहिए जिसे कोई भी व्यक्ति पढ़ सके. अगर staffId मौजूद है, तो यह फ़ील्ड भी मौजूद होना चाहिए. |
room |
उस कमरे का आईडी जहां यह सेवा उपलब्ध है. हालांकि, यह आईडी देना ज़रूरी नहीं है. इस फ़ील्ड से, सभी कारोबारियों/कंपनियों/कारोबारियों के संगठनों, सेवाओं, और उपलब्धता के रिकॉर्ड में मौजूद कमरे की पहचान की जाती है. साथ ही, यह समय के साथ स्थिर भी होना चाहिए, ताकि पिछली बुकिंग के साथ इसका मिलान किया जा सके. अगर roomName मौजूद है, तो यह फ़ील्ड भी मौजूद होना चाहिए. |
room |
इस रूम में मौजूद सेवा के लिए कोई नाम. यह नाम देना ज़रूरी नहीं है. यह फ़ील्ड, बुकिंग करने वाले उपयोगकर्ताओं को दिखेगा. साथ ही, यह ऐसा होना चाहिए जिसे कोई भी व्यक्ति पढ़ सके. (ज़रूरी नहीं, लेकिन अगर roomId मौजूद है, तो ज़रूरी है) डाइनिंग में, रूम के नाम का इस्तेमाल सिर्फ़ बार या पैटिओ जैसे बैठने की जगहों के लिए किया जाना चाहिए. इसका इस्तेमाल, तय कीमत वाले मेन्यू, खास गतिविधियों या रूम से जुड़ी किसी अन्य वैल्यू (जैसे, बुकिंग या डिनर) के लिए नहीं किया जाना चाहिए. हमारा सुझाव है कि डिफ़ॉल्ट रूप से बैठने की जगह के साथ कोई रूम न जोड़ा जाए. |
party |
सिर्फ़ खाने-पीने के लिए बुकिंग करने पर लागू: इस टाइम स्लॉट के दौरान, पार्टी में शामिल होने वाले लोगों की संख्या. एक रेस्टोरेंट को एक ही समय के लिए कई स्लॉट से जोड़ा जा सकता है. हर स्लॉट में, पार्टी के साइज़ की जानकारी अलग-अलग दी जा सकती है. उदाहरण के लिए, अगर बुकिंग के साथ दो, तीन या चार लोगों को बैठाया जा सकता है. |
room |
ज़रूरी नहीं. स्थानीय भाषा में चैट रूम का ब्यौरा. अगर यह सेट है, तो डिफ़ॉल्ट वैल्यू देना ज़रूरी है. कारोबारी की लोकेल के लिए, आम तौर पर इस्तेमाल होने वाली भाषाएं भी उपलब्ध कराना बेहतर होता है. (ज़रूरी नहीं) |
बार-बार होने वाला
बार-बार होने वाले अपॉइंटमेंट के मैसेज भेजना ज़रूरी नहीं है. हालांकि, इससे लगातार उपलब्ध रहने वाले अपॉइंटमेंट स्लॉट को ज़्यादा कॉम्पैक्ट तरीके से दिखाया जा सकता है. आम तौर पर, ये एक दिन के काम के शेड्यूल को दिखाते हैं. इसके बाद, ScheduleException मैसेज का इस्तेमाल, काम के दिन के दौरान बुक की गई/उपलब्ध नहीं होने वाली समयसीमाओं को दिखाने के लिए किया जाता है.
ज़रूरतें:
- उपलब्धता स्लॉट या बार-बार होने वाले स्लॉट को बड़ा करने पर, एक जैसे स्लॉट नहीं होने चाहिए. अगर आईडी, startTime, अवधि, और रिसॉर्स मैच करते हैं, तो स्लॉट एक जैसे माने जाते हैं.
- किसी एक सेवा के स्लॉट में, उपलब्धता के स्टैंडर्ड फ़ॉर्मैट और बार-बार होने की जानकारी को एक साथ न डालें. बार-बार होने वाली अपॉइंटमेंट बुकिंग की सुविधा, उन कारोबारियों/सेवाओं के लिए फ़ायदेमंद है जो अपॉइंटमेंट बुक करने की सुविधा देती हैं. स्टैंडर्ड फ़ॉर्मैट, उन कारोबारियों/सेवाओं के लिए है जो नियमित तौर पर शेड्यूल की गई क्लास उपलब्ध कराते हैं.
- टास्क दोहराए जाने की अवधि 24 घंटे से ज़्यादा नहीं होनी चाहिए.
JSON के काेड में दिखाना |
---|
{ "repeatUntil": string, "repeatEvery": string } |
फ़ील्ड | |
---|---|
repeat |
यूटीसी टाइमस्टैंप, जब तक कि उपलब्धता दोहराई जाती है. आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: |
repeat |
यह उपलब्धता के एक स्लॉट के बाद अगले स्लॉट के बीच का समय तय करता है. उदाहरण: अगर किसी शो के लिए उपलब्धता की अवधि 20 मिनट, हर 30 मिनट के बाद दोहराए जाने की अवधि, सुबह 9:00 बजे, और दोहराए जाने की आखिरी तारीख सुबह 11:00 बजे है, तो उसके लिए सुबह 9 से 9:20 बजे, सुबह 9:30 से 9:50 बजे, सुबह 10 से 10:20 बजे, सुबह 10:30 से 10:50 बजे, और सुबह 11 से 11:20 बजे के स्लॉट मिलेंगे. (ज़रूरी) सेकंड में कुल समय, जिसमें दशमलव के बाद नौ अंक हो सकते हैं. यह समय ' |
ScheduleException
ScheduleException मैसेज, कामकाजी दिनों में बुक की गई/उपलब्ध नहीं होने वाली समयसीमाओं के बारे में बताते हैं. ये समयसीमाएं, ऊपर बताई गई बार-बार होने वाली शेड्यूल की सुविधा के अपवाद हैं. अपॉइंटमेंट के लिए स्लॉट बुक होने पर, अपवादों की सूची को अपडेट किया जाना चाहिए, ताकि नई समयसीमाएं उपलब्ध न होने की जानकारी दिख सके. टास्क के दोहराए जाने की फ़्रीक्वेंसी में बदलाव नहीं किया जाना चाहिए.
JSON के काेड में दिखाना |
---|
{
"timeRange": {
object ( |
फ़ील्ड | |
---|---|
time |
अपवाद की समयसीमा. अगर बार-बार होने वाले अपॉइंटमेंट के लिए तय किए गए स्लॉट, कारोबार के बंद होने और खुलने के समय से ओवरलैप होते हैं, तो उन्हें उपलब्ध नहीं माना जाएगा. उदाहरण: अगर बार-बार होने वाली मीटिंग के लिए, समयसीमा 20 मिनट, हर 30 मिनट में दोहराएं, शुरू होने का समय सुबह 9:00 बजे, और दोहराए जाने की समयसीमा सुबह 11:00 बजे तक है, तो ScheduleException की timeRange सुबह 9:45 बजे से सुबह 11:00 बजे तक होने पर, सुबह 9:30 बजे से 9:50 बजे, सुबह 10 बजे से 10:20 बजे, और सुबह 10:30 बजे से 10:50 बजे के स्लॉट उपलब्ध नहीं होंगे. ध्यान दें कि समयसीमा 'बंद है' से 'खुला है' है. इसलिए, सुबह 11 बजे से शुरू होने वाले स्लॉट पर कोई असर नहीं पड़ेगा. |
पूर्व-भुगतान
यह वह पेमेंट है जो उपयोगकर्ता से, बुकिंग के दौरान लिया जा सकता है.
JSON के काेड में दिखाना |
---|
{
"priceInfo": {
object ( |
फ़ील्ड | |
---|---|
price |
कीमत की जानकारी के लिए कंटेनर. |
PriceInfo
कीमत की जानकारी के लिए कंटेनर.
JSON के काेड में दिखाना |
---|
{ "priceType": enum ( |
फ़ील्ड | |
---|---|
price |
इससे यह तय होता है कि कीमत या कीमत की सीमा (हर व्यक्ति के हिसाब से या तय की गई) कैसे लागू की जाती है |
यूनियन फ़ील्ड price_options . कीमत के विकल्पों में, कीमत की सटीक जानकारी या कीमत की सीमा शामिल होती है. price_options इनमें से कोई एक हो सकता है: |
|
price |
किसी सेवा या शुल्क की कीमत. |
price |
किसी सेवा या शुल्क की ऊपरी और/या निचली सीमा. |
PriceRange
मॉनेटरी वैल्यू की रेंज के लिए रैपर. जब तक दोनों वैल्यू सेट नहीं की जातीं, तब तक इसे अनबाउंड वैल्यू माना जाता है. minAmount और maxAmount में से कम से कम एक का होना ज़रूरी है.
JSON के काेड में दिखाना |
---|
{ "minPrice": { object ( |
फ़ील्ड | |
---|---|
min |
कम से कम रकम. |
max |
ज़्यादा से ज़्यादा रकम. यह वैल्यू हमेशा minPrice से ज़्यादा होनी चाहिए. |
DurationRequirement
इस एनम से पता चलता है कि अनुरोध किए गए स्लॉट की अवधि/खत्म होने का समय स्वीकार करने या देखने के लिए, उपयोगकर्ता को कौनसी ज़रूरी शर्तें पूरी करनी होंगी.
Enums | |
---|---|
DURATION_REQUIREMENT_UNSPECIFIED |
खत्म होने के समय को मैनेज करने के बारे में नहीं बताया गया है. यह डिफ़ॉल्ट रूप से होता है. |
DO_NOT_SHOW_DURATION |
उपयोगकर्ता को खत्म होने का समय नहीं दिखाया जाता. |
MUST_SHOW_DURATION |
अपॉइंटमेंट बुक करने से पहले, उपयोगकर्ता को खत्म होने का समय दिखाना ज़रूरी है. |
SchedulingRuleOverrides
उपलब्धता के लेवल के शेड्यूलिंग नियम.
JSON के काेड में दिखाना |
---|
{ "lastBookableSec": string, "firstBookableSec": string, "lastOnlineCancellableSec": string } |
फ़ील्ड | |
---|---|
last |
यह स्लॉट पिछली बार कब बुक किया गया था (सेकंड में). यह टाइमस्टैंप, स्लॉट के startSec से पहले होना चाहिए. अगर उपयोगकर्ताओं को शुरू होने के समय के बाद बुकिंग करनी है, तो सेवा के लेवल पर SchedulingRules.min_booking_before_end_time का इस्तेमाल करें. अगर यह मौजूद है, तो इसकी वैल्यू, उस सेवा के SchedulingRules के min_booking_buffer में बताई गई किसी भी वैल्यू को बदल देगी. |
first |
इस स्लॉट को बुक करने के लिए, पहली बार (सेकंड में) बुकिंग की गई. यह टाइमस्टैंप, स्लॉट के startSec या lastBookableSec से पहले का होना चाहिए. |
last |
अगर यह सेट है, तो यह उस समय (यूनिक्स काल से सेकंड में) की जानकारी देता है जब Reserve with Google की मदद से, इस अपॉइंटमेंट स्लॉट को रद्द किया जा सकता है. यह फ़ील्ड, सेवा रद्द करने से जुड़े सभी नियमों को बदल देगा. (ज़रूरी नहीं) |
ConfirmationMode
बुकिंग के लिए उपलब्धता की पुष्टि करने के तरीके.
Enums | |
---|---|
CONFIRMATION_MODE_UNSPECIFIED |
पुष्टि करने के मोड की जानकारी नहीं दी गई थी. सिंक होने की पुष्टि मान ली जाएगी. |
CONFIRMATION_MODE_SYNCHRONOUS |
इस अवधि के लिए बुकिंग की पुष्टि एक साथ की जाएगी. |
CONFIRMATION_MODE_ASYNCHRONOUS |
इस समयावधि के लिए बुकिंग की पुष्टि, अलग-अलग समय पर की जाएगी. |
LinkoutRequiredReason
किसी स्लॉट में लिंकआउट अनुभव मौजूद होने की वजह.
Enums | |
---|---|
LINKOUT_REQUIRED_REASON_UNSPECIFIED |
डिफ़ॉल्ट वैल्यू: इसका इस्तेमाल न करें. यह वैल्यू, 'जानकारी नहीं है' के बराबर होती है. |
PAYMENT_REQUIRED |
स्लॉट बुक करने के लिए, पार्टनर प्लैटफ़ॉर्म पर पेमेंट करना ज़रूरी है. |
तरीके |
|
---|---|
|
यह फ़ंक्शन, किसी एग्रीगेटर के ज़रिए मैनेज किए जा रहे व्यापारी/कंपनी/कारोबारी के मौजूदा Service के Availability को बदल देता है और उसे दिखाता है. |