कोडिंग लेवल: इंटरमीडिएट
अवधि: 30 मिनट
प्रोजेक्ट टाइप: Google Workspace ऐड-ऑन
मकसद
- यह समझना कि समाधान क्या करता है.
- जानें कि समाधान में Apps Script की सेवाएं क्या करती हैं.
- एनवायरमेंट सेट अप करें.
- स्क्रिप्ट सेट अप करें.
- स्क्रिप्ट चलाएं.
इस समाधान के बारे में जानकारी
Google Sheets के मैक्रो को एक स्प्रेडशीट से दूसरी स्प्रेडशीट में मैन्युअल तरीके से कॉपी करने में समय लग सकता है और गड़बड़ी की आशंका भी होती है. Google Workspace का यह ऐड-ऑन, स्क्रिप्ट प्रोजेक्ट को अपने-आप कॉपी करता है और उसे उपयोगकर्ता की बताई गई स्प्रेडशीट में अटैच करता है. हालांकि, यह समाधान Sheets मैक्रो पर फ़ोकस करता है, लेकिन इसका इस्तेमाल किसी भी कंटेनर-बाउंड स्क्रिप्ट को कॉपी करने और शेयर करने के लिए किया जा सकता है.
यह कैसे काम करता है
यह स्क्रिप्ट, ओरिजनल स्प्रेडशीट से जुड़े Apps Script प्रोजेक्ट को कॉपी करती है और उपयोगकर्ता की बताई गई स्प्रेडशीट से जुड़ा डुप्लीकेट Apps Script प्रोजेक्ट बनाती है.
Apps Script की सेवाएं
यह समाधान इन सेवाओं का इस्तेमाल करता है:
- यूआरएल फ़ेच करने की सेवा–सोर्स प्रोजेक्ट को कॉपी करने और उसकी कॉपी बनाने के लिए, AppsScript API से कनेक्ट होती है.
- स्क्रिप्ट सेवा–यह अनुमति देता है कि Apps Script API, अनुमति के लिए दोबारा अनुरोध न करे.
- स्प्रेडशीट सेवा–कॉपी किए गए Apps Script प्रोजेक्ट को जोड़ने के लिए, टारगेट स्प्रेडशीट खोलती है.
- कार्ड सेवा–यह ऐड-ऑन का यूज़र इंटरफ़ेस बनाता है.
ज़रूरी शर्तें
इस सैंपल का इस्तेमाल करने के लिए, आपको ये ज़रूरी शर्तें पूरी करनी होंगी:
- Google खाता (Google Workspace खातों के लिए, एडमिन की अनुमति की ज़रूरत पड़ सकती है).
इंटरनेट का ऐक्सेस वाला वेब ब्राउज़र.
Apps Script डैशबोर्ड की सेटिंग में, Google Apps Script API चालू होना चाहिए.
अपना एनवायरमेंट सेट अप करने का तरीका
Google Cloud Console में अपना Cloud प्रोजेक्ट खोलें
अगर यह पहले से नहीं खुला है, तो वह Cloud प्रोजेक्ट खोलें जिसका इस्तेमाल आपको इस सैंपल के लिए करना है:
- Google Cloud Console में, कोई प्रोजेक्ट चुनें पेज पर जाएं.
- वह Google Cloud प्रोजेक्ट चुनें जिसका इस्तेमाल करना है. इसके अलावा, प्रोजेक्ट बनाएं पर क्लिक करें और स्क्रीन पर दिए गए निर्देशों का पालन करें. Google Cloud प्रोजेक्ट बनाने पर, आपको उस प्रोजेक्ट के लिए बिलिंग की सुविधा चालू करनी पड़ सकती है.
Google Apps Script API चालू करना
यह क्विकस्टार्ट, Google Apps Script API का इस्तेमाल करता है.
Google API का इस्तेमाल करने से पहले, आपको उन्हें Google Cloud प्रोजेक्ट में चालू करना होगा. किसी एक Google Cloud प्रोजेक्ट में, एक या उससे ज़्यादा एपीआई चालू किए जा सकते हैं.अपने Cloud प्रोजेक्ट में, Google Apps Script API को चालू करें.
OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करना
Google Workspace के ऐड-ऑन के लिए, सहमति वाली स्क्रीन का कॉन्फ़िगरेशन ज़रूरी है. अपने ऐड-ऑन की OAuth सहमति स्क्रीन को कॉन्फ़िगर करने से यह तय होता है कि Google, उपयोगकर्ताओं को क्या दिखाएगा.
- Google Cloud console में, मेन्यू > > ब्रैंडिंग पर जाएं.
- अगर आपने पहले से ही को कॉन्फ़िगर कर लिया है, तो ब्रैंडिंग, ऑडियंस, और डेटा ऐक्सेस में जाकर, OAuth सहमति स्क्रीन की ये सेटिंग कॉन्फ़िगर की जा सकती हैं. अगर आपको अभी तक कॉन्फ़िगर नहीं किया गया मैसेज दिखता है, तो शुरू करें पर क्लिक करें:
- ऐप्लिकेशन की जानकारी में जाकर, ऐप्लिकेशन का नाम में ऐप्लिकेशन का नाम डालें.
- उपयोगकर्ता सहायता ईमेल में, सहायता पाने के लिए कोई ईमेल पता चुनें. अगर उपयोगकर्ताओं को अपनी सहमति के बारे में कोई सवाल पूछना है, तो वे आपसे इस पते पर संपर्क कर सकते हैं.
- आगे बढ़ें पर क्लिक करें.
- ऑडियंस सेक्शन में जाकर, इंटरनल चुनें.
- आगे बढ़ें पर क्लिक करें.
- संपर्क जानकारी में जाकर, वह ईमेल पता डालें जिस पर आपको अपने प्रोजेक्ट में हुए किसी भी बदलाव के बारे में सूचना दी जा सके.
- आगे बढ़ें पर क्लिक करें.
- पूरा करें में जाकर, Google API सेवाओं के उपयोगकर्ता के डेटा की नीति पढ़ें. अगर आप सहमत हैं, तो मैं Google API सेवाओं के उपयोगकर्ता के डेटा की नीति से सहमत हूं को चुनें.
- जारी रखें पर क्लिक करें.
- बनाएं पर क्लिक करें.
- फ़िलहाल, स्कोप जोड़ने की प्रोसेस को छोड़ा जा सकता है. आने वाले समय में, जब आप अपने Google Workspace संगठन के बाहर इस्तेमाल करने के लिए कोई ऐप्लिकेशन बनाएं, तो आपको उपयोगकर्ता टाइप को बाहरी पर सेट करना होगा. इसके बाद, अनुमति के ऐसे स्कोप जोड़ें जिनकी आपके ऐप्लिकेशन को ज़रूरत है. ज़्यादा जानने के लिए, OAuth की सहमति कॉन्फ़िगर करने से जुड़ी पूरी गाइड देखें.
स्क्रिप्ट सेट अप करना
Apps Script प्रोजेक्ट बनाना
- मैक्रो शेयर करें वाला Apps Script प्रोजेक्ट खोलने के लिए, इस बटन पर क्लिक करें.
प्रोजेक्ट खोलना - खास जानकारी पर क्लिक करें.
- खास जानकारी वाले पेज पर, कॉपी बनाएं
पर क्लिक करें.
Cloud प्रोजेक्ट का नंबर कॉपी करना
- Google Cloud console में, मेन्यू > IAM और एडमिन > सेटिंग पर जाएं.
- प्रोजेक्ट नंबर फ़ील्ड में, वैल्यू कॉपी करें.
Apps Script प्रोजेक्ट का Cloud प्रोजेक्ट सेट करना
- कॉपी किए गए Apps Script प्रोजेक्ट में,
प्रोजेक्ट सेटिंग
पर क्लिक करें.
- Google Cloud Platform (GCP) प्रोजेक्ट में जाकर, प्रोजेक्ट बदलें पर क्लिक करें.
- GCP प्रोजेक्ट नंबर में, Google Cloud प्रोजेक्ट नंबर चिपकाएं.
- प्रोजेक्ट सेट करें पर क्लिक करें.
टेस्ट डिप्लॉयमेंट इंस्टॉल करना
- कॉपी किए गए Apps Script प्रोजेक्ट में, एडिटर पर क्लिक करें.
UI.gs
फ़ाइल खोलें और चालू करें पर क्लिक करें. जब आपसे कहा जाए, तब स्क्रिप्ट को अनुमति दें.- डिप्लॉय करें > डिप्लॉयमेंट की जांच करें पर क्लिक करें.
- इंस्टॉल करें > हो गया पर क्लिक करें.
मैक्रो स्क्रिप्ट और स्प्रेडशीट की जानकारी पाना
- Sheets की वह स्प्रेडशीट खोलें जिसमें कोई मैक्रो हो और जिसे बदलने की अनुमति आपके पास हो. सैंपल स्प्रेडशीट का इस्तेमाल करने के लिए, सैंपल मैक्रो स्प्रेडशीट की कॉपी बनाएं.
- एक्सटेंशन > Apps Script पर क्लिक करें.
- Apps Script प्रोजेक्ट में, प्रोजेक्ट सेटिंग
पर क्लिक करें.
- स्क्रिप्ट आईडी में जाकर, कॉपी करें पर क्लिक करें.
- स्क्रिप्ट आईडी को सेव कर लें, ताकि अगले चरण में इसका इस्तेमाल किया जा सके.
- वह स्प्रेडशीट खोलें या नई स्प्रेडशीट बनाएं जिसमें आपको मैक्रो जोड़ना है. आपके पास स्प्रेडशीट में बदलाव करने की अनुमति होनी चाहिए.
- स्प्रेडशीट का यूआरएल कॉपी करें और उसे बाद में इस्तेमाल करने के लिए सेट कर दें.
स्क्रिप्ट चलाना
पक्का करें कि आपकी डैशबोर्ड सेटिंग में, Google Apps Script API चालू हो. अपनी स्क्रिप्ट चलाने के लिए, नीचे दिए गए सेक्शन में दिया गया तरीका अपनाएं.
मैक्रो कॉपी करना
- Sheets में, दाएं साइडबार में, शेयर मैक्रो ऐड-ऑन
खोलें.
- सोर्स मैक्रो में जाकर, स्क्रिप्ट आईडी चिपकाएं.
- टारगेट स्प्रेडशीट में जाकर, स्प्रेडशीट का यूआरएल चिपकाएं.
- मैक्रो शेयर करें पर क्लिक करें.
- ऐक्सेस की अनुमति दें पर क्लिक करें और ऐड-ऑन को अनुमति दें.
- दूसरा से चौथा चरण दोहराएं.
कॉपी किया गया मैक्रो खोलना
- अगर वह पहले से खुली हुई नहीं है, तो वह स्प्रेडशीट खोलें जिसमें आपने मैक्रो कॉपी किया है.
- एक्सटेंशन > Apps Script पर क्लिक करें.
- अगर आपको कॉपी किया गया Apps Script प्रोजेक्ट नहीं दिखता है, तो पक्का करें कि डैशबोर्ड की सेटिंग में Google Apps Script API चालू हो. इसके बाद, मैक्रो कॉपी करें में दिया गया तरीका दोहराएं.
कोड की समीक्षा करना
इस समाधान के लिए Apps Script कोड की समीक्षा करने के लिए, नीचे दिए गए सोर्स कोड देखें पर क्लिक करें:
सोर्स कोड देखें
Code.gs
UI.gs
appsscript.json
योगदानकर्ता
इस सैंपल को Google, Google Developer Experts की मदद से मैनेज करता है.
अगले चरण
- ऐड-ऑन की मदद से, Google Workspace का बेहतर इस्तेमाल करना
- Google Workspace के ऐड-ऑन बनाना
- ऐप्लिकेशन पब्लिश करना