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. इंटरैक्टिव सुविधाएं में जाकर, इंटरैक्टिव सुविधाएं चालू करें पर क्लिक करें इंटरैक्टिव सुविधाओं को बंद करने के लिए, टॉगल करके बंद स्थिति पर जाएं चैट ऐप्लिकेशन.

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