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