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 > एपीआई और सेवाएं > OAuth की सहमति वाली स्क्रीन पर जाएं.

   OAuth की सहमति वाली स्क्रीन पर जाना

2. उपयोगकर्ता टाइप के लिए, इंटरनल चुनें. इसके बाद, बनाएं पर क्लिक करें.
3. ऐप्लिकेशन रजिस्ट्रेशन फ़ॉर्म को पूरा करें. इसके बाद, सेव करें और जारी रखें पर क्लिक करें.

4. फ़िलहाल, स्कोप जोड़ने की प्रोसेस को छोड़ा जा सकता है. इसके बाद, सेव करें और जारी रखें पर क्लिक करें. आने वाले समय में, जब आप अपने Google Workspace संगठन के बाहर इस्तेमाल करने के लिए कोई ऐप्लिकेशन बनाएं, तो आपको उपयोगकर्ता टाइप को बाहरी में बदलना होगा. इसके बाद, अपने ऐप्लिकेशन के लिए अनुमति के ज़रूरी स्कोप जोड़ें.

5. अपने ऐप्लिकेशन के रजिस्ट्रेशन की खास जानकारी देखें. बदलाव करने के लिए, बदलाव करें पर क्लिक करें. अगर ऐप्लिकेशन रजिस्ट्रेशन ठीक लगता है, तो डैशबोर्ड पर वापस जाएं पर क्लिक करें.

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 की बेहतर सेवाओं के दस्तावेज़