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 API का इस्तेमाल करने से पहले, आपको उन्हें Google Cloud प्रोजेक्ट में चालू करना होगा. किसी एक Google Cloud प्रोजेक्ट में, एक या उससे ज़्यादा एपीआई चालू किए जा सकते हैं.

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

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

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

1. Google Cloud Console में, मेन्यू पर जाएं > एपीआई और सेवाएं > 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. स्क्रिप्ट एडिटर का कॉन्टेंट, नीचे दिए गए कोड से बदलें:

chat/quickstart/Code.gs

GitHub पर देखें

/**
 * 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 में, मेन्यू पर जाएं > IAM और एडमिन > सेटिंग पर क्लिक करें.

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

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

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

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

Google Chat API चालू करना

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

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

chat/quickstart/appsscript.json

GitHub पर देखें

{
  "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 एडिटर में, Run पर क्लिक करें.

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

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

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

इससे काम हो गया!

बढ़िया! ज़्यादा जानने के लिए, नीचे दिया गया सेक्शन देखें.

कोई समस्या हुई

बुमर, हमें बताएं कि क्या गड़बड़ी हुई. हमारी समस्या हल करने वाले सेक्शन में, कुछ सामान्य गड़बड़ियों और उनके समाधान के बारे में नीचे बताया गया है. अगर आपको कोड में कोई गड़बड़ी मिलती है, GitHub पर समस्या की शिकायत करें या पुल का अनुरोध सबमिट करें.

अगले चरण

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