Google Apps Script के बारे में खास जानकारी

क्विकस्टार्ट में, Google Workspace API को कॉल करने वाले ऐप्लिकेशन को सेट अप और चलाने का तरीका बताया गया है.

Google Workspace के क्विकस्टार्ट, पुष्टि करने और अनुमति देने की प्रोसेस की कुछ जानकारी को मैनेज करने के लिए, एपीआई क्लाइंट लाइब्रेरी का इस्तेमाल करते हैं. हमारा सुझाव है कि आप अपने ऐप्लिकेशन के लिए क्लाइंट लाइब्रेरी का इस्तेमाल करें. इस क्विकस्टार्ट में, पुष्टि करने के लिए आसान तरीके का इस्तेमाल किया गया है. यह तरीका, टेस्टिंग एनवायरमेंट के लिए सही है. हमारा सुझाव है कि प्रोडक्शन एनवायरमेंट के लिए, अपने ऐप्लिकेशन के लिए सही ऐक्सेस क्रेडेंशियल चुनने से पहले, पुष्टि और अनुमति के बारे में जानें.

ऐसा Google Apps स्क्रिप्ट बनाएं जो Google Chat API को अनुरोध करता हो.

मकसद

• एनवायरमेंट कॉन्फ़िगर करें.
• स्क्रिप्ट बनाना और कॉन्फ़िगर करना.
• स्क्रिप्ट चलाएं.

ज़रूरी शर्तें

• Google Cloud प्रोजेक्ट.

• Business या Enterprise वर्शन वाला Google Workspace खाता, जिसमें Google Chat का ऐक्सेस हो.

अपना Cloud प्रोजेक्ट कॉन्फ़िगर करना

अगर इस शुरुआती लेख को पढ़ने के लिए, किसी नए Google Cloud प्रोजेक्ट का इस्तेमाल किया जा रहा है, तो आपको उसे कॉन्फ़िगर करना होगा. साथ ही, खुद को टेस्ट उपयोगकर्ता के तौर पर जोड़ना होगा. अगर आपने अपने Cloud प्रोजेक्ट के लिए, ये चरण पहले ही पूरे कर लिए हैं, तो अगले सेक्शन पर जाएं.

Google Cloud Console में अपना Cloud प्रोजेक्ट खोलें

अगर यह पहले से नहीं खुला है, तो वह Cloud प्रोजेक्ट खोलें जिसका इस्तेमाल आपको इस सैंपल के लिए करना है:

1. Google Cloud Console में, कोई प्रोजेक्ट चुनें पेज पर जाएं.

   कोई Cloud प्रोजेक्ट चुनना

2. वह Google Cloud प्रोजेक्ट चुनें जिसका इस्तेमाल करना है. इसके अलावा, प्रोजेक्ट बनाएं पर क्लिक करें और स्क्रीन पर दिए गए निर्देशों का पालन करें. Google Cloud प्रोजेक्ट बनाने पर, आपको उस प्रोजेक्ट के लिए बिलिंग की सुविधा चालू करनी पड़ सकती है.

Chat API को चालू करना

• Google Cloud console में, Google Chat API को चालू करें.

  एपीआई को चालू करना

OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करना

1. Google Cloud console में, मेन्यू menu > > ब्रैंडिंग पर जाएं.

   ब्रैंडिंग पर जाएं

2. अगर आपने पहले से ही को कॉन्फ़िगर कर लिया है, तो ब्रैंडिंग, ऑडियंस, और डेटा ऐक्सेस में जाकर, OAuth सहमति स्क्रीन की ये सेटिंग कॉन्फ़िगर की जा सकती हैं. अगर आपको अभी तक कॉन्फ़िगर नहीं किया गया मैसेज दिखता है, तो शुरू करें पर क्लिक करें:
1. ऐप्लिकेशन की जानकारी में जाकर, ऐप्लिकेशन का नाम में ऐप्लिकेशन का नाम डालें.
2. उपयोगकर्ता सहायता ईमेल में, सहायता पाने के लिए कोई ईमेल पता चुनें. अगर उपयोगकर्ताओं को अपनी सहमति के बारे में कोई सवाल पूछना है, तो वे आपसे इस पते पर संपर्क कर सकते हैं.
3. आगे बढ़ें पर क्लिक करें.
4. ऑडियंस सेक्शन में जाकर, इंटरनल चुनें.
5. आगे बढ़ें पर क्लिक करें.
6. संपर्क जानकारी में जाकर, वह ईमेल पता डालें जिस पर आपको अपने प्रोजेक्ट में हुए किसी भी बदलाव के बारे में सूचना दी जा सके.
7. आगे बढ़ें पर क्लिक करें.
8. पूरा करें में जाकर, Google API सेवाओं के उपयोगकर्ता के डेटा की नीति पढ़ें. अगर आप सहमत हैं, तो मैं Google API सेवाओं के उपयोगकर्ता के डेटा की नीति से सहमत हूं को चुनें.
9. जारी रखें पर क्लिक करें.
10. बनाएं पर क्लिक करें.
3. फ़िलहाल, स्कोप जोड़ने की प्रोसेस को छोड़ा जा सकता है. आने वाले समय में, जब आप अपने Google Workspace संगठन के बाहर इस्तेमाल करने के लिए कोई ऐप्लिकेशन बनाएं, तो आपको उपयोगकर्ता टाइप को बाहरी पर सेट करना होगा. इसके बाद, अनुमति के ऐसे स्कोप जोड़ें जिनकी आपके ऐप्लिकेशन को ज़रूरत है. ज़्यादा जानने के लिए, OAuth की सहमति कॉन्फ़िगर करने से जुड़ी पूरी गाइड देखें.

Google Chat ऐप्लिकेशन को कॉन्फ़िगर करना

Google Chat API को कॉल करने के लिए, आपको Google Chat ऐप्लिकेशन को कॉन्फ़िगर करना होगा. डेटा लिखने के किसी भी अनुरोध के लिए, Google Chat, यूज़र इंटरफ़ेस (यूआई) में Google Chat ऐप्लिकेशन को एट्रिब्यूट करता है. इसके लिए, यह नीचे दी गई जानकारी का इस्तेमाल करता है.

1. Google Cloud Console में, Chat API के कॉन्फ़िगरेशन पेज पर जाएं:

   Chat API के कॉन्फ़िगरेशन पेज पर जाना

2. ऐप्लिकेशन की जानकारी में जाकर, यह जानकारी डालें:

   1. ऐप्लिकेशन का नाम फ़ील्ड में, Chat API quickstart app डालें.
   2. अवतार का यूआरएल फ़ील्ड में, https://developers.google.com/chat/images/quickstart-app-avatar.png डालें.
   3. ब्यौरा फ़ील्ड में, Quickstart for calling the Chat API डालें.

3. Chat ऐप्लिकेशन के लिए इंटरैक्टिव सुविधाएं बंद करने के लिए, इंटरैक्टिव सुविधाएं में जाकर, इंटरैक्टिव सुविधाएं चालू करें पर क्लिक करें. इसके बाद, टॉगल को बंद की स्थिति पर स्विच करें.

4. सेव करें पर क्लिक करें.

स्क्रिप्ट बनाना

1. script.google.com/create पर जाकर, नई स्क्रिप्ट बनाएं.
2. स्क्रिप्ट एडिटर के कॉन्टेंट को इस कोड से बदलें:

/**
 * This quickstart sample shows how to list spaces with user credential
 *
 * It relies on the OAuth2 scope 'https://www.googleapis.com/auth/chat.spaces.readonly'
 * referenced in the manifest file (appsscript.json).
 */
function listSpaces() {
  // Initialize request argument(s)
  // Filter spaces by space type (SPACE or GROUP_CHAT or DIRECT_MESSAGE)
  const filter = 'space_type = "SPACE"';

  // Iterate through the response pages using page tokens
  let responsePage;
  let pageToken = null;
  do {
    // Request response pages
    responsePage = Chat.Spaces.list({
      filter: filter,
      pageToken: pageToken
    });
    // Handle response pages
    if (responsePage.spaces) {
      responsePage.spaces.forEach((space) => console.log(space));
    }
    // Update the page token to the next one
    pageToken = responsePage.nextPageToken;
  } while (pageToken);
}

3. सेव करें पर क्लिक करें.
4. बिना टाइटल वाला प्रोजेक्ट पर क्लिक करें. इसके बाद, क्विकस्टार्ट टाइप करें और नाम बदलें पर क्लिक करें.

स्क्रिप्ट कॉन्फ़िगर करना

Cloud प्रोजेक्ट का नंबर कॉपी करना

1. Google Cloud console में, मेन्यू menu > IAM और एडमिन > सेटिंग पर जाएं.

   आईएएम और एडमिन सेटिंग पर जाएं

2. प्रोजेक्ट नंबर फ़ील्ड में, वैल्यू कॉपी करें.

अपना Google Cloud प्रोजेक्ट लिंक करना

1. Apps Script प्रोजेक्ट खोलें.
2. प्रोजेक्ट सेटिंग settings पर क्लिक करें.
3. Google Cloud Platform (GCP) प्रोजेक्ट में जाकर, प्रोजेक्ट बदलें पर क्लिक करें.
4. GCP प्रोजेक्ट नंबर में, Google Cloud प्रोजेक्ट नंबर चिपकाएं.
5. प्रोजेक्ट सेट करें पर क्लिक करें.

Google Chat API को चालू करना

1. Apps Script प्रोजेक्ट खोलें.

1. प्रोजेक्ट सेटिंग settings पर क्लिक करें.
2. सामान्य सेटिंग में जाकर, एडिटर में "appsscript.json" मेनिफ़ेस्ट फ़ाइल दिखाएं को चालू करें.
3. एडिटर code पर क्लिक करें. इसके बाद, फ़ाइल appscript.json चुनें और कॉन्टेंट को इस कोड से बदलें:

{
  "timeZone": "America/New_York",
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "oauthScopes": [
    "https://www.googleapis.com/auth/chat.spaces.readonly"
  ],
  "chat": {},
  "dependencies": {
    "enabledAdvancedServices": [{
      "userSymbol": "Chat",
      "version": "v1",
      "serviceId": "chat"
    }]
  }
}

सैंपल चलाना

Apps Script एडिटर में, चालू करें पर क्लिक करें.

सैंपल को पहली बार चलाने पर, आपको ऐक्सेस की अनुमति देने के लिए कहा जाएगा:

1. अनुमतियां देखें पर क्लिक करें.
2. कोई खाता चुनें.
3. अनुमति दें पर क्लिक करें.

स्क्रिप्ट के लागू होने का लॉग, विंडो में सबसे नीचे दिखता है.

अगले चरण

• Google Apps Script की बेहतर सेवाओं के दस्तावेज़