इस पेज पर, Google Forms API के लिए Apps Script वेब ऐप्लिकेशन के उदाहरण के बारे में खास जानकारी दी गई है.
ज़रूरी शर्तें
- अपने Google Cloud प्रोजेक्ट में Forms API चालू करें.
- सैंपल वेब ऐप्लिकेशन के लिए, GitHub README फ़ाइल में बताए गए तरीके से, नया Apps Script प्रोजेक्ट सेट अप करें.
खास जानकारी
Forms API की मदद से, पुष्टि किया गया कोई भी क्लाइंट, REST का इस्तेमाल करके सीधे तौर पर एपीआई को ऐक्सेस कर सकता है.
Apps Script, मान्य OAuth ऐक्सेस टोकन पाने और REST कॉल करने का तरीका उपलब्ध कराता है. इसलिए, Apps Script को सीधे तौर पर Forms API के साथ इंटिग्रेट किया जा सकता है. Apps Script में पहले से ही Forms Service उपलब्ध है. इसकी मदद से, स्क्रिप्ट, फ़ॉर्म बना सकती हैं, उन्हें ऐक्सेस कर सकती हैं, और उनमें बदलाव कर सकती हैं. हालांकि, अगर आपको Apps Script से सीधे तौर पर Forms API का इस्तेमाल करना है, तो OAuth ऐक्सेस को इस तरह सेट अप करें:
स्कोप किया गया और पुष्टि किया गया OAuth ऐक्सेस टोकन पाएं.
ScriptApp.getOAuthToken();एपीआई को किए गए किसी भी REST कॉल में दिए गए options आर्ग्युमेंट में OAuth टोकन शामिल करें.
UrlFetchApp.fetch(Url, options);
इसे ऐक्शन में देखने के लिए, Apps Script प्रोजेक्ट सेट अप करना लेख पढ़ें. सेटअप गाइड में, एपीआई को कॉल करने के लिए ज़रूरी इन्फ़्रास्ट्रक्चर के बारे में बताया गया है. हालांकि, उपयोगकर्ताओं को एपीआई का आसानी से ऐक्सेस देने के लिए, हमारे सैंपल वेब ऐप्लिकेशन को आज़माया और उसमें बदलाव भी किया जा सकता है.
वेब ऐप्लिकेशन के इस्तेमाल का उदाहरण
Forms API के सभी तरीकों को सीधे तौर पर कॉल करने वाला वेब ऐप्लिकेशन, apps-script-samples GitHub रिपॉज़िटरी में उपलब्ध है.
वेब ऐप्लिकेशन चलाना
प्रोजेक्ट सेट अप करने और उसे वेब ऐप्लिकेशन के तौर पर डिप्लॉय करने के बाद, कुछ कार्रवाइयां की जा सकती हैं.
फ़ॉर्म बनाएं बटन पर क्लिक करके, नया फ़ॉर्म बनाएं.
अब नया फ़ॉर्म, फ़ॉर्म आईडी: फ़ील्ड में दिखता है. इसे खोलने के लिए, Forms में खोलें पर क्लिक करें.
नई विंडो में नया फ़ॉर्म खोलने के बाद, कुछ सवाल मैन्युअल तरीके से जोड़ें. इसके बाद, आईडी के हिसाब से फ़ॉर्म पाएं पर क्लिक करें. आपको दाईं ओर JSON आउटपुट में अपने नए सवाल दिखेंगे.
ऐप्लिकेशन में उपलब्ध अन्य तरीकों के बारे में जानें. साथ ही, हर ऑपरेशन के लिए दाईं ओर मौजूद आउटपुट देखें.
Forms की घड़ियों के साथ काम करना
फ़ॉर्म वॉच के बटन भी देखें. ये Forms API की वॉच सुविधा का इस्तेमाल करते हैं. साथ ही, वॉच बनाने, सूची बनाने, मिटाने, और रिन्यू करने जैसी कार्रवाइयां करते हैं. इनका इस्तेमाल करने के लिए, आपको Cloud Pub/Sub विषयों के साथ एक प्रोजेक्ट सेट अप करना होगा.
Forms API की वॉच और Cloud Pub/Sub के बारे में ज़्यादा जानने के लिए, पुश नोटिफ़िकेशन सेट अप करना और उन्हें पाना लेख पढ़ें.
अगले चरण
उदाहरण के तौर पर दिए गए ऐप्लिकेशन को अपनी ज़रूरतों के हिसाब से कस्टमाइज़ करके देखें. यहां कुछ उदाहरण दिए गए हैं:
- Google शीट में सवाल बैंक बनाएं. इसके बाद, नई फ़ॉर्म में सवाल भरने के लिए, Apps Script की SpreadsheetApp सेवा का इस्तेमाल करके, शीट से सवाल फ़ेच करें.
- इसके अलावा, आपके पास सवालों के बैंक को SQL डेटाबेस में रखने का विकल्प भी होता है. यहां, Apps Script की JDBC सेवा का इस्तेमाल करके, डेटाबेस से सवालों को फ़ॉर्म में भरा जा सकता है.
- क्विज़ जनरेट करें और स्कोर को Google Sheets की ग्रेड बुक में सेव करें.
- Cloud Pub/Sub की मदद से अपना प्रोजेक्ट सेट अप करें. साथ ही, watches सुविधा का इस्तेमाल करके, छात्र-छात्राओं के लिए रीयल-टाइम में लीडरबोर्ड जनरेट करें, ताकि क्विज़ के नतीजे दिखाए जा सकें.