कोडिंग लेवल: इंटरमीडिएट
अवधि: 30 मिनट
प्रोजेक्ट टाइप: Google Workspace ऐड-ऑन
मकसद
- समझें कि समाधान क्या करता है.
- यह समझना कि Apps Script सेवाएं समाधान.
- एनवायरमेंट को सेट अप करना.
- स्क्रिप्ट सेट अप करें.
- स्क्रिप्ट चलाएं.
इस समाधान के बारे में जानकारी
Google शीट मैक्रो को एक स्प्रैडशीट से दूसरी स्प्रैडशीट में मैन्युअल रूप से कॉपी किया जा सकता है इसमें ज़्यादा समय लगता है और गड़बड़ी होने की आशंका भी होती है. Google Workspace का यह ऐड-ऑन अपने-आप चालू हो जाता है स्क्रिप्ट प्रोजेक्ट को कॉपी करता है और उसे उपयोगकर्ता की तय की गई स्प्रेडशीट में जोड़ता है. हालांकि यह समाधान, Sheets के मैक्रो पर फ़ोकस करता है. इसका इस्तेमाल कॉपी करने के लिए किया जा सकता है और कंटेनर-बाउंड स्क्रिप्ट को शेयर करें.
यह कैसे काम करता है
स्क्रिप्ट, मूल स्प्रेडशीट बनाई जाती है और डुप्लीकेट Apps Script प्रोजेक्ट बनाया जाता है उपयोगकर्ता-बताई गई स्प्रेडशीट से सीमित होता है.
Apps Script सेवाएं
यह समाधान, इन सेवाओं का इस्तेमाल करता है:
- यूआरएल फ़ेच सेवा–ऐप्लिकेशन से कनेक्ट होती है सोर्स प्रोजेक्ट को कॉपी करने और कॉपी बनाने के लिए, Script API का इस्तेमाल करें.
- स्क्रिप्ट सेवा–Apps स्क्रिप्ट को अनुमति देती है पुष्टि करने के दूसरे अनुरोध से बचने के लिए, एपीआई का इस्तेमाल करें.
- स्प्रेडशीट सेवा–टारगेट सेट अप करता है कॉपी की गई Apps Script प्रोजेक्ट को जोड़ने के लिए स्प्रेडशीट.
- कार्ड सेवा–यह ऐड-ऑन का यूज़र इंटरफ़ेस बनाता है.
ज़रूरी शर्तें
इस सैंपल का इस्तेमाल करने के लिए, आपको इन शर्तों को पूरा करना होगा:
- Google खाता (Google Workspace खाते एडमिन की अनुमति ज़रूरी है).
इंटरनेट ऐक्सेस करने वाला वेब ब्राउज़र.
Google Apps Script API को Apps Script डैशबोर्ड सेटिंग.
अपना एनवायरमेंट सेट अप करें
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 Workspace का इस्तेमाल करता है, तो आपको उपयोगकर्ता टाइप को बदलकर बाहरी करना होगा. इसके बाद, अनुमति के वे दायरे जोड़ें जो आपके ऐप्लिकेशन के लिए ज़रूरी हैं.
- अपने ऐप्लिकेशन रजिस्ट्रेशन की खास जानकारी देखें. बदलाव करने के लिए, बदलाव करें पर क्लिक करें. अगर ऐप्लिकेशन पंजीकरण के लिए ठीक लगता है, तो डैशबोर्ड पर वापस जाएं पर क्लिक करें.
स्क्रिप्ट सेट अप करें
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
फ़ाइल खोलें और Run पर क्लिक करें. जब कहा जाए, तब स्क्रिप्ट.- डिप्लॉयमेंट > डिप्लॉयमेंट की जांच करें पर क्लिक करें.
- इंस्टॉल करें > हो गया पर क्लिक करें.
मैक्रो स्क्रिप्ट और स्प्रेडशीट की जानकारी हासिल करें
- ऐसी Sheets स्प्रेडशीट खोलें जिसमें मैक्रो हो और जिसके लिए आपके पास इसकी अनुमति हो बदलाव करें. स्प्रेडशीट का नमूना इस्तेमाल करने के लिए, सैंपल मैक्रो की कॉपी बनाएं स्प्रेडशीट.
- एक्सटेंशन > Apps Script पर क्लिक करें.
- Apps Script प्रोजेक्ट में, प्रोजेक्ट सेटिंग .
- स्क्रिप्ट आईडी में, कॉपी करें पर क्लिक करें.
- स्क्रिप्ट आईडी को बाद के चरण में इस्तेमाल करने के लिए अलग सेट करें.
- एक नई स्प्रेडशीट खोलें या बनाएं, जिसमें आप मैक्रो जोड़ना चाहते हैं. आपको ऐसा ज़रूर करना चाहिए आपके पास स्प्रेडशीट में बदलाव करने की अनुमति होती है.
- स्प्रेडशीट के यूआरएल को कॉपी करें और उसे बाद के चरण में इस्तेमाल करने के लिए अलग रखें.
स्क्रिप्ट चलाएं
पक्का करें कि आपकी डैशबोर्ड सेटिंग में Google Apps Script API चालू है. अपनी स्क्रिप्ट चलाने के लिए, नीचे दिए गए सेक्शन में दिया गया तरीका अपनाएं.
मैक्रो कॉपी करें
- Sheets में, दाएं साइडबार पर, शेयर मैक्रो ऐड-ऑन खोलें .
- सोर्स मैक्रो में जाकर, स्क्रिप्ट आईडी चिपकाएं.
- टारगेट स्प्रेडशीट में जाकर, स्प्रेडशीट का यूआरएल चिपकाएं.
- मैक्रो शेयर करें पर क्लिक करें.
- ऐक्सेस की अनुमति दें पर क्लिक करें और ऐड-ऑन को अनुमति दें.
- चरण 2-4 को दोहराएं.
कॉपी किया गया मैक्रो खोलें
- अगर यह पहले से नहीं खुला है, तो वह स्प्रेडशीट खोलें जिसमें आपने मैक्रो कॉपी किया है.
- एक्सटेंशन > Apps Script पर क्लिक करें.
- अगर आपको कॉपी किया गया Apps Script प्रोजेक्ट नहीं दिखता है, तो पक्का करें कि डैशबोर्ड में Google Apps Script API चालू है सेटिंग और मैक्रो कॉपी करें में दिए गए चरणों को दोहराएं.
कोड की समीक्षा करें
इस समाधान के लिए Apps Script कोड की समीक्षा करने के लिए, क्लिक करें नीचे सोर्स कोड देखें:
सोर्स कोड देखें
Code.gs
UI.gs
appsscript.json
योगदानकर्ता
Google इस सैंपल को मैनेज करता है. इसके लिए, Google Developer के विशेषज्ञों की मदद ली जाती है.
अगले चरण
- ऐड-ऑन की मदद से, Google Workspace का बेहतर इस्तेमाल करना
- Google Workspace ऐड-ऑन बनाना
- ऐप्लिकेशन पब्लिश करना