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

Google Apps Script बनाएं, जो Google Chat API को अनुरोध भेजता हो.

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

Apps Script में, Google Workspace की क्विकस्टार्ट गाइड, Google Workspace API को कॉल करने के लिए Google की ऐडवांस सेवाओं का इस्तेमाल करती हैं. साथ ही, पुष्टि करने और अनुमति देने के फ़्लो की कुछ जानकारी को मैनेज करती हैं.

मकसद

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

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

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

• आपके पास Business या Enterprise वर्शन वाला Google Workspace खाता होना चाहिए. साथ ही, आपके पास Google Chat को ऐक्सेस करने की अनुमति होनी चाहिए.

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

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

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

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

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

   कोई क्लाउड प्रोजेक्ट चुनें

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

Chat API चालू करना

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

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

उस स्क्रीन को कॉन्फ़िगर करना जहां OAuth के लिए सहमति दी जाती है

1. Google Cloud Console में, मेन्यू menu &gt Google Auth platform &gt ब्रैंडिंग पर जाएं.

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

2. अगर आपने पहले ही Google Auth platformको कॉन्फ़िगर कर लिया है, तो ब्रैंडिंग, दर्शक, और डेटा ऐक्सेस में जाकर, OAuth सहमति स्क्रीन की इन सेटिंग को कॉन्फ़िगर किया जा सकता है. अगर आपको Google Auth platform अभी तक कॉन्फ़िगर नहीं किया गया है मैसेज दिखता है, तो शुरू करें पर क्लिक करें:
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 पर जाकर, Apps Script एडिटर में नई स्क्रिप्ट बनाएं.
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. बिना टाइटल वाला प्रोजेक्ट पर क्लिक करें. इसके बाद, Quickstart टाइप करें और नाम बदलें पर क्लिक करें.

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

क्लाउड प्रोजेक्ट का नंबर कॉपी करें

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

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

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

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

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

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

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 की ऐडवांस सेवाओं के बारे में जानकारी देने वाला दस्तावेज़
• APIs explorer में Google Workspace API आज़माना