फ़ॉर्म
साइन-अप फ़ॉर्म, उन्हें भरने वाले लोग, और उनके आँकड़े।
फ़ॉर्म टूल
| टूल | यह क्या करता है |
|---|---|
| listForms | वर्कस्पेस के साइन-अप फ़ॉर्म, सबसे हाल में बदले गए पहले, उनकी स्थिति, साइन-अप और व्यू के साथ। |
| getForm | एक फ़ॉर्म पूरी तरह: उसके फ़ील्ड, सामग्री, ऑडियंस, डबल ऑप्ट-इन और सूचनाएँ। प्रकाशित फ़ॉर्म में उसका लिंक, एम्बेड कोड और वह पता भी जुड़ता है जिस पर सादा HTML फ़ॉर्म भेजता है, और includeDesign ड्राफ़्ट को JSON के रूप में लौटाता है। |
| listFormStarters | वे शुरुआती ढाँचे जिनसे कोई नया फ़ॉर्म शुरू हो सकता है, हर एक के माँगे गए फ़ील्ड के साथ। |
| createForm | किसी शुरुआती ढाँचे से, document के रूप में लिखे गए डिज़ाइन से, या ऊपर से बदलाव किए गए शुरुआती ढाँचे से, किसी भी सेटिंग के साथ फ़ॉर्म बनाएँ। जब तक publish true न हो, वह ड्राफ़्ट ही रहता है। |
| updateForm | फ़ॉर्म का नाम और सेटिंग्स बदलें, जो तुरंत लागू होती हैं, या document के ज़रिए उसका ड्राफ़्ट डिज़ाइन बदलें। सामग्री और स्टाइल कुंजी-दर-कुंजी मिलाए जाते हैं, और fields पूरी सूची को बदल देता है। |
| publishForm | मौजूदा ड्राफ़्ट को वह बनाएँ जो विज़िटर देखते हैं, ताकि फ़ॉर्म साइन-अप ले। |
| setFormStatus | किसी प्रकाशित फ़ॉर्म को रोकें, या उसे फिर से खोलें। |
| duplicateForm | किसी फ़ॉर्म को नए ड्राफ़्ट में कॉपी करें, उसके साइन-अप के बिना। |
| deleteForm | किसी फ़ॉर्म और उसके साइन-अप को हमेशा के लिए हटाएँ। उसका लिंक और एम्बेड काम करना बंद कर देते हैं, और जिन लोगों को उसने जोड़ा था वे आपके संपर्कों में बने रहते हैं। |
| getFormAnalytics | किसी अवधि में व्यू, साइन-अप, जोड़े गए लोग और अब भी प्रतीक्षा कर रहे लोग, और कन्वर्ज़न दर, कुल मिलाकर और मिनट, घंटे या दिन के हिसाब से। व्यू घंटे के हिसाब से रखे जाते हैं। |
| listFormSubmissions | वे लोग जिन्होंने कोई फ़ॉर्म भरा, नए पहले, उनके जवाबों और स्थिति के साथ, एक बार में एक पेज। ईमेल पते से खोजें और स्थिति के हिसाब से छाँटें। |
| getFormSubmission | एक साइन-अप पूरी तरह: हर जवाब, उसकी स्थिति, वह कब आया और व्यक्ति कब जोड़ा गया, वह किस पेज से आया और उसकी ऑडियंस। |
| approveFormSubmission | पुष्टि की प्रतीक्षा कर रहे साइन-अप को ईमेल के बिना जोड़ें। इसके लिए contacts:write भी चाहिए। |
| resendFormConfirmation | अब भी प्रतीक्षा कर रहे साइन-अप को नया पुष्टि लिंक ईमेल करें। अगर इस फ़ॉर्म ने पिछले दस मिनट में उस पते को ईमेल किया हो, या उस पते को पिछले एक दिन में इस वर्कस्पेस से पाँच मिल चुके हों, तो कुछ नहीं भेजा जाता। इसके लिए emails:send भी चाहिए। |
| removeFormSubmissions | किसी फ़ॉर्म के 200 तक साइन-अप id से हटाएँ। संपर्क और ऑडियंस जैसे हैं वैसे ही रहते हैं। |
पढ़ने के लिए forms:read और हर बदलाव के लिए forms:write चाहिए। हर वह काम जिससे फ़ॉर्म मेल भेजता है, उसके लिए emails:send भी चाहिए: डबल ऑप्ट-इन चालू करना, भेजने वाला पता या पुष्टि ईमेल सेट करना, डबल ऑप्ट-इन फ़ॉर्म को प्रकाशित करना या खोलना, और पुष्टि ईमेल फिर से भेजना। किसी सदस्य की ओर से काम करने वाला क्लाइंट सिर्फ़ वही फ़ॉर्म देखता है जो उस सदस्य ने बनाए, और कुछ पतों तक सीमित क्लाइंट सिर्फ़ उन्हीं पतों से पुष्टि ईमेल भेज सकता है, और उन्हीं पतों को सूचना दे सकता है, जिन तक वह पहुँच सकता है।
लिखित ब्रीफ़ से फ़ॉर्म डिज़ाइन करना ऐप की चैट में होता है। MCP पर क्लाइंट ही डिज़ाइनर है: फ़ील्ड, सामग्री और स्टाइल को document के रूप में createForm या updateForm को दें, और टूल डिज़ाइन को व्यवस्थित करते हैं और बताते हैं कि उन्होंने क्या बदला।
इस सर्वर के सात टूल ऐसा बदलाव करते हैं जिसे REST API सत्यापन कोड से सुरक्षित रखता है, और वही कोड माँगते हैं: createRule, setRuleEnabled, removeDomain, removeDomainAddress, removeAppHost, deleteForm और आपकी बनाई ऑडियंस पर deleteAudience। जब तक क्लाइंट ने पिछले 60 मिनट में कोई कोड सत्यापित न किया हो, और व्यक्ति ने अकाउंट → कनेक्टेड ऐप्स में उसके लिए "60 मिनट के लिए बदलावों की अनुमति दें" न चुना हो, ऐसा टूल एक ऐसे नतीजे से जवाब देता है जो Refused (step_up_required): से शुरू होता है, और कुछ नहीं बदलता। emptyAudience कभी कोड नहीं माँगता। API का प्रमाणीकरण पेज बताता है कि कोड कैसे माँगें और सत्यापित करें।
टूल वही नियम और अस्वीकृतियाँ लागू करते हैं जो REST API लागू करता है, और API रेफ़रेंस के /forms पेज हर फ़ील्ड का वर्णन करते हैं। listForms आख़िरी बदलाव के हिसाब से क्रम लगाता है, और createForm और updateForm अधूरे document को व्यवस्थित करते हैं, जबकि API उसे पूरा लेता है।
