क्विकस्टार्ट में, Google Workspace API को कॉल करने वाले ऐप्लिकेशन को सेट अप करने और चलाने का तरीका बताया गया है.
Google Workspace के क्विकस्टार्ट, पुष्टि करने और अनुमति देने की प्रोसेस की कुछ जानकारी को मैनेज करने के लिए, एपीआई क्लाइंट लाइब्रेरी का इस्तेमाल करते हैं. हमारा सुझाव है कि आप अपने ऐप्लिकेशन के लिए क्लाइंट लाइब्रेरी का इस्तेमाल करें. इस क्विकस्टार्ट में, पुष्टि करने के लिए आसान तरीके का इस्तेमाल किया गया है. यह तरीका, टेस्टिंग एनवायरमेंट के लिए सही है. हमारा सुझाव है कि प्रोडक्शन एनवायरमेंट के लिए, अपने ऐप्लिकेशन के लिए सही ऐक्सेस क्रेडेंशियल चुनने से पहले, पुष्टि और अनुमति के बारे में जानें.
ऐसा Java कमांड-लाइन ऐप्लिकेशन बनाएं जो Google Chat API को ऐक्सेस करने के अनुरोध करता हो.
मकसद
- अपना एनवायरमेंट सेट अप करें.
- सैंपल सेट अप करें.
- सैंपल चलाएं.
ज़रूरी शर्तें
- Java 1.8 या इसके बाद का वर्शन.
- Gradle 7.0 या इसके बाद का वर्शन.
- Google Cloud प्रोजेक्ट.
- आपके पास Business या Enterprise Google Workspace खाता हो, जिसमें Google Chat का ऐक्सेस हो.
अपना एनवायरमेंट सेट अप करना
यह शुरुआती लेख पूरा करने के लिए, अपना एनवायरमेंट सेट अप करें.
एपीआई चालू करना
Google API का इस्तेमाल करने से पहले, आपको उन्हें Google Cloud प्रोजेक्ट में चालू करना होगा. किसी एक Google Cloud प्रोजेक्ट में, एक या उससे ज़्यादा एपीआई चालू किए जा सकते हैं.Google Cloud console में, Google Chat API को चालू करें.
उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है
अगर इस क्विकस्टार्ट को पूरा करने के लिए किसी नए Google Cloud प्रोजेक्ट का इस्तेमाल किया जा रहा है, तो OAuth के लिए सहमति वाली स्क्रीन कॉन्फ़िगर करें और खुद को टेस्ट उपयोगकर्ता के तौर पर जोड़ें. अगर आपने अपने Cloud प्रोजेक्ट के लिए यह चरण पहले ही पूरा कर लिया है, तो अगले सेक्शन पर जाएं.
- Google Cloud Console में, मेन्यू > एपीआई और सेवाएं > OAuth की सहमति वाली स्क्रीन पर जाएं.
- उपयोगकर्ता टाइप के लिए, इंटरनल चुनें. इसके बाद, बनाएं पर क्लिक करें.
- ऐप्लिकेशन रजिस्ट्रेशन फ़ॉर्म को पूरा करें. इसके बाद, सेव करें और जारी रखें पर क्लिक करें.
फ़िलहाल, दायरों को जोड़ना स्किप किया जा सकता है. इसके बाद, सेव करें और जारी रखें पर क्लिक करें. आने वाले समय में, जब आप अपने Google Workspace संगठन के बाहर इस्तेमाल करने के लिए कोई ऐप्लिकेशन बनाएं, तो आपको उपयोगकर्ता टाइप को बाहरी में बदलना होगा. इसके बाद, अपने ऐप्लिकेशन के लिए अनुमति के ज़रूरी स्कोप जोड़ें.
- अपने ऐप्लिकेशन के रजिस्ट्रेशन की खास जानकारी देखें. बदलाव करने के लिए, बदलाव करें पर क्लिक करें. अगर ऐप्लिकेशन का रजिस्ट्रेशन ठीक है, तो डैशबोर्ड पर वापस जाएं पर क्लिक करें.
किसी डेस्कटॉप ऐप्लिकेशन के लिए क्रेडेंशियल को अनुमति देना
असली उपयोगकर्ताओं की पुष्टि करने और अपने ऐप्लिकेशन में उपयोगकर्ता का डेटा ऐक्सेस करने के लिए, आपको एक या एक से ज़्यादा OAuth 2.0 क्लाइंट आईडी बनाने होंगे. क्लाइंट आईडी का इस्तेमाल, Google के OAuth सर्वर पर किसी एक ऐप्लिकेशन की पहचान करने के लिए किया जाता है. अगर आपका ऐप्लिकेशन कई प्लैटफ़ॉर्म पर काम करता है, तो आपको हर प्लैटफ़ॉर्म के लिए अलग-अलग क्लाइंट आईडी बनाना होगा.- Google Cloud console में, मेन्यू > एपीआई और सेवाएं > क्रेडेंशियल पर जाएं.
- क्रेडेंशियल बनाएं > OAuth क्लाइंट आईडी पर क्लिक करें.
- ऐप्लिकेशन का टाइप > डेस्कटॉप ऐप्लिकेशन पर क्लिक करें.
- नाम फ़ील्ड में, क्रेडेंशियल के लिए कोई नाम टाइप करें. यह नाम सिर्फ़ Google Cloud Console में दिखता है.
- बनाएं पर क्लिक करें. OAuth क्लाइंट बनने के बाद, आपको एक स्क्रीन दिखेगी. इसमें आपका नया क्लाइंट आईडी और क्लाइंट पासवर्ड दिखेगा.
- ठीक है पर क्लिक करें. नया क्रेडेंशियल, OAuth 2.0 क्लाइंट आईडी में दिखता है.
- डाउनलोड की गई JSON फ़ाइल को
credentials.json
के तौर पर सेव करें और फ़ाइल को अपनी वर्किंग डायरेक्ट्री में ले जाएं.
Google Chat ऐप्लिकेशन को कॉन्फ़िगर करना
Google Chat API को कॉल करने के लिए, आपको Google Chat ऐप्लिकेशन को कॉन्फ़िगर करना होगा. डेटा लिखने के किसी भी अनुरोध के लिए, Google Chat, यूज़र इंटरफ़ेस (यूआई) में Google Chat ऐप्लिकेशन को एट्रिब्यूट करता है. इसके लिए, यह नीचे दी गई जानकारी का इस्तेमाल करता है.
Google Cloud Console में, Chat API के कॉन्फ़िगरेशन पेज पर जाएं:
आवेदन की जानकारी में, यह जानकारी डालें:
- ऐप्लिकेशन का नाम फ़ील्ड में,
Chat API quickstart app
डालें. - अवतार का यूआरएल फ़ील्ड में,
https://developers.google.com/chat/images/quickstart-app-avatar.png
डालें. - ब्यौरा फ़ील्ड में,
Quickstart for calling the Chat API
डालें.
- ऐप्लिकेशन का नाम फ़ील्ड में,
चैट ऐप्लिकेशन में इंटरैक्टिव सुविधाएं बंद करने के लिए, इंटरैक्टिव सुविधाएं में जाकर, इंटरैक्टिव सुविधाएं चालू करें टॉगल पर क्लिक करके, टॉगल को बंद करें.
सेव करें पर क्लिक करें.
फ़ाइल फ़ोल्डर तैयार करना
अपनी वर्किंग डायरेक्ट्री में, प्रोजेक्ट का नया स्ट्रक्चर बनाएं:
gradle init --type basic mkdir -p src/main/java src/main/resources
src/main/resources/
डायरेक्ट्री में,credentials.json
फ़ाइल को कॉपी करें, जिसे आपने पहले डाउनलोड किया था.डिफ़ॉल्ट
build.gradle
फ़ाइल खोलें और उसके कॉन्टेंट को यहां दिए गए कोड से बदलें:
सैंपल सेट अप करना
src/main/java/
डायरेक्ट्री में, एक नई Java फ़ाइल बनाएं. इसका नाम,build.gradle
फ़ाइल में मौजूदmainClassName
वैल्यू से मेल खाना चाहिए.अपनी नई Java फ़ाइल में यह कोड शामिल करें:
सैंपल चलाना
सैंपल चलाएं:
gradle run
-
सैंपल को पहली बार चलाने पर, आपको ऐक्सेस की अनुमति देने के लिए कहा जाएगा:
- अगर आपने Google खाते में पहले से साइन इन नहीं किया है, तो कहा जाने पर साइन इन करें. अगर आपने एक से ज़्यादा खातों में साइन इन किया है, तो अनुमति देने के लिए कोई एक खाता चुनें.
- स्वीकार करें पर क्लिक करें.
आपका Java ऐप्लिकेशन Google Chat API को चलाता है और उसे कॉल करता है.
अनुमति देने की जानकारी फ़ाइल सिस्टम में सेव होती है. इसलिए, अगली बार जब आप सैंपल कोड को चलाएंगे, तो आपको अनुमति देने के लिए नहीं कहा जाएगा.