क्लाइंट लाइब्रेरी, Google Chat API को कॉल करने के लिए डेवलपर अनुभव को ऑप्टिमाइज़ करती हैं. ऐसा, आपको लिखने वाले बोयलरप्लेट कोड को कम करके किया जाता है. इस गाइड में क्लाइंट लाइब्रेरी के बारे में बताया गया है. साथ ही, उन्हें इंस्टॉल करने का तरीका भी बताया गया है.
Chat API में gRPC और REST इंटरफ़ेस के साथ-साथ, दोनों के साथ काम करने वाली क्लाइंट लाइब्रेरी भी हैं. Cloud क्लाइंट लाइब्रेरी, gRPC और REST इंटरफ़ेस के साथ काम करती हैं. वहीं, Google API क्लाइंट लाइब्रेरी सिर्फ़ REST इंटरफ़ेस के साथ काम करती हैं. हालांकि, एक ही प्रोजेक्ट में दोनों क्लाइंट लाइब्रेरी का इस्तेमाल किया जा सकता है. अगर दी गई क्लाइंट लाइब्रेरी आपकी ज़रूरतों के मुताबिक नहीं हैं, तो आपके पास अपनी क्लाइंट लाइब्रेरी लिखने का विकल्प है. ये लाइब्रेरी, gRPC या REST इंटरफ़ेस का इस्तेमाल करती हैं.
Google पर काम करने वाली क्लाइंट लाइब्रेरी के टाइप के बारे में ज़्यादा जानने के लिए, क्लाइंट लाइब्रेरी के बारे में जानकारी देखें.
Cloud क्लाइंट लाइब्रेरी इंस्टॉल करना (सुझाया गया)
Chat API को कॉल करने के लिए, क्लाउड क्लाइंट लाइब्रेरी सबसे नई और सुझाई गई क्लाइंट लाइब्रेरी हैं. Cloud क्लाइंट लाइब्रेरी, gRPC और REST इंटरफ़ेस, दोनों के साथ काम करती हैं.
Chat API, इन भाषाओं के लिए Cloud क्लाइंट लाइब्रेरी उपलब्ध कराता है. वह भाषा चुनें जिसका इस्तेमाल करना है:
Node.js
क्लाइंट लाइब्रेरी इंस्टॉल करने के लिए:
npm install @google-apps/chat
ज़्यादा जानें:
Python
क्लाइंट लाइब्रेरी इंस्टॉल करने के लिए:
python -m venv <your-env>
source <your-env>/bin/activate
pip install google-apps-chat
ज़्यादा जानें:
Java
इन टैब से अपना बिल्ड एनवायरमेंट चुनें. इनमें से किसी भी टूल का इस्तेमाल करें, लेकिन GitHub पर उपलब्ध सबसे नए वर्शन पर अपडेट करना न भूलें.
BOM वाला Maven
अगर BOM के साथ Maven का इस्तेमाल किया जा रहा है, तो अपनी pom.xml
फ़ाइल में यह जोड़ें:
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>libraries-bom</artifactId>
<version>26.42.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-chat</artifactId>
</dependency>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-chat</artifactId>
<version>0.10.0</version>
</dependency>
BOM के बिना Maven
अगर BOM के बिना Maven का इस्तेमाल किया जा रहा है, तो अपनी डिपेंडेंसी में इसे जोड़ें:
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-chat</artifactId>
<version>0.9.0</version>
</dependency>
ग्रेडल
अगर BOM के बिना Gradle का इस्तेमाल किया जा रहा है, तो अपनी डिपेंडेंसी में यह जोड़ें:
implementation 'com.google.cloud:google-cloud-chat:0.10.0'
SBT
अगर SBT का इस्तेमाल किया जा रहा है, तो इसे अपनी डिपेंडेंसी में जोड़ें:
libraryDependencies += "com.google.cloud" % "google-cloud-chat" % "0.10.0"
ज़्यादा जानें:
शुरू करें
Google Cloud की सेवाओं के लिए Go पैकेज इंपोर्ट करें.
import "cloud.google.com/go"
अपने सिस्टम पर पैकेज इंस्टॉल करने के लिए:
- अपनी प्रोजेक्ट डायरेक्ट्री में बदलें:
cd /my/cloud/project
. - वह पैकेज पाएं जिसका आपको इस्तेमाल करना है:
go get cloud.google.com/go/chat
ज़्यादा जानें:
Ruby
क्लाइंट लाइब्रेरी इंस्टॉल करने के लिए:
gem install google-apps-chat
ज़्यादा जानें:
PHP
क्लाइंट लाइब्रेरी इंस्टॉल करने के लिए:
- अगर ज़रूरी हो, तो डिपेंडेंसी मैनेजर Composer इंस्टॉल करें.
- कमांड-लाइन इंटरफ़ेस में, यह कमांड चलाएं:
composer require google/apps-chat
ज़्यादा जानें:
.NET
क्लाइंट लाइब्रेरी इंस्टॉल करने के लिए:
NuGet से Google.Apps.Chat.V1
पैकेज इंस्टॉल करें. इसे अपने प्रोजेक्ट में सामान्य तरीके से जोड़ें. उदाहरण के लिए, Visual Studio में प्रोजेक्ट पर दायां क्लिक करके, "NuGet पैकेज मैनेज करें..." चुनें. पक्का करें कि आपने रिलीज़ से पहले उपलब्ध पैकेज चालू किए हों. उदाहरण के लिए, Visual Studio NuGet के यूज़र इंटरफ़ेस में, "रिलीज़ से पहले उपलब्ध पैकेज शामिल करें" बॉक्स को चुनें.
NuGet पैकेज इंस्टॉल करने के लिए, NuGet.org पर Google.Apis पर जाएं.
ज़्यादा जानें:
Google API क्लाइंट लाइब्रेरी इंस्टॉल करना
Google API क्लाइंट लाइब्रेरी, Cloud क्लाइंट लाइब्रेरी का एक विकल्प है. ये लाइब्रेरी, REST संसाधनों और तरीकों का इस्तेमाल करके, Chat API को प्रोग्राम के हिसाब से ऐक्सेस करने की सुविधा देती हैं. अगर आपने ऐसी भाषा का इस्तेमाल किया है जिसके लिए Cloud क्लाइंट लाइब्रेरी उपलब्ध नहीं है या किसी ऐसे प्रोजेक्ट को बड़ा किया जा रहा है जो पहले से ही इनका इस्तेमाल करता है, तो हो सकता है कि आप Google API क्लाइंट लाइब्रेरी का इस्तेमाल करना चाहें.
Chat API, इन भाषाओं के लिए Google API क्लाइंट लाइब्रेरी उपलब्ध कराता है. वह भाषा चुनें जिसका इस्तेमाल करना है:
शुरू करें
Go (अल्फ़ा) के लिए, Google Chat API की क्लाइंट लाइब्रेरी का नया वर्शन पाएं. क्लाइंट लाइब्रेरी का इस्तेमाल करने से जुड़ी डेवलपर की गाइड पढ़ें.
Java
इस पेज में Java के लिए, Google API की क्लाइंट लाइब्रेरी का इस्तेमाल करके, Google Chat API का इस्तेमाल शुरू करने के बारे में जानकारी दी गई है. ज़्यादा जानकारी के लिए, यहां दिए गए दस्तावेज़ देखें:
अपने प्रोजेक्ट में क्लाइंट लाइब्रेरी जोड़ना
इन टैब से अपना बिल्ड एनवायरमेंट (Maven या Gradle) चुनें:
अपनी pom.xml
फ़ाइल में ये चीज़ें जोड़ें:
अपनी build.gradle
फ़ाइल में ये चीज़ें जोड़ें:
JavaScript
क्लाइंट लाइब्रेरी का इस्तेमाल करने से जुड़ी डेवलपर गाइड पढ़ें.
.NET
इस पेज में .NET के लिए, Google API की क्लाइंट लाइब्रेरी का इस्तेमाल करके, Google Chat API का इस्तेमाल शुरू करने के बारे में जानकारी दी गई है. ज़्यादा जानकारी के लिए, यहां दिए गए दस्तावेज़ देखें:
लाइब्रेरी डाउनलोड करना
NuGet पैकेज Google.Apis इंस्टॉल करें.
Node.js
Node.js के लिए Google Chat API की क्लाइंट लाइब्रेरी का नया वर्शन पाएं. क्लाइंट लाइब्रेरी का इस्तेमाल करने से जुड़ी डेवलपर की गाइड पढ़ें.
Obj-C
Objective-C के लिए Google Chat API की क्लाइंट लाइब्रेरी का नया वर्शन डाउनलोड करें. क्लाइंट लाइब्रेरी का इस्तेमाल करने से जुड़ी डेवलपर की गाइड पढ़ें.
PHP
PHP के लिए Google Chat API की क्लाइंट लाइब्रेरी का नया वर्शन डाउनलोड करें. क्लाइंट लाइब्रेरी का इस्तेमाल करने से जुड़ी डेवलपर की गाइड पढ़ें.
Python
इस पेज पर, Python के लिए Google API की क्लाइंट लाइब्रेरी का इस्तेमाल करके, Google Chat API का इस्तेमाल शुरू करने के बारे में जानकारी दी गई है. ज़्यादा जानकारी के लिए, यहां दिए गए दस्तावेज़ देखें:
सिस्टम की ज़रूरतें
- ऑपरेटिंग सिस्टम:
- Linux
- macOS X
- Windows
- Python 2.7 या 3.4 या इससे नए वर्शन
क्लाइंट लाइब्रेरी इंस्टॉल करना
पैकेज मैनेजर का इस्तेमाल किया जा सकता है. इसके अलावा, Python की क्लाइंट लाइब्रेरी को मैन्युअल तरीके से डाउनलोड और इंस्टॉल किया जा सकता है:
इंस्टॉल करने के तरीके को मैनेज करना
अपने इंस्टॉल करने के तरीके को मैनेज करने के लिए, पीआईपी या setuptools का इस्तेमाल करें. आपको पहले sudo
चलाने की ज़रूरत पड़ सकती है.
- पीआईपी (इसका इस्तेमाल करना बेहतर होगा):
pip install --upgrade google-api-python-client
- Setuptools:
easy_install --upgrade google-api-python-client
मैन्युअल तरीके से इंस्टॉल करना
- Python के लिए क्लाइंट लाइब्रेरी का नया वर्शन डाउनलोड करें.
- कोड को अनपैक करें.
- इंस्टॉल करें:
python setup.py install
App Engine
Python की क्लाइंट लाइब्रेरी को App Engine Python रनटाइम एनवायरमेंट में इंस्टॉल नहीं किया गया है. इन्हें तीसरे पक्ष की लाइब्रेरी की तरह आपके ऐप्लिकेशन में कॉपी किया जाना चाहिए.
Ruby
इस पेज पर, Ruby के लिए Google API की क्लाइंट लाइब्रेरी का इस्तेमाल करके, Google Chat API का इस्तेमाल शुरू करने के बारे में जानकारी दी गई है. ज़्यादा जानकारी के लिए, यहां दिए गए दस्तावेज़ देखें:
google-api-client
जेम को इंस्टॉल करना
अपने सिस्टम के हिसाब से, आपको इन कमांड को sudo
के साथ जोड़ना होगा.
अगर आपने Ruby के लिए, Google API क्लाइंट लाइब्रेरी को इंस्टॉल नहीं किया है, तो RubyGems
का इस्तेमाल करके इंस्टॉल करें:
gem install google-api-client
अगर आपने पहले से ही जेम इंस्टॉल किया है, तो इसे नए वर्शन में अपडेट करें:
gem update -y google-api-client
Ruby के लिए Google API क्लाइंट लाइब्रेरी का इस्तेमाल शुरू करना
अपना पहला अनुरोध कैसे करें. इसके बारे में जानने के लिए, शुरुआती निर्देश देखें.
Apps Script और क्लाइंट लाइब्रेरी
ज़्यादातर डेवलपर के लिए, Google Chat API को कॉल करने का सुझाया गया तरीका यह है कि वे अपनी पसंदीदा भाषा, जैसे कि Python, Java या Node.js के लिए, आधिकारिक तौर पर काम करने वाली क्लाउड क्लाइंट लाइब्रेरी का इस्तेमाल करें.
अगर Google Apps Script का इस्तेमाल करके कोडिंग की जा रही है, तो क्लाइंट लाइब्रेरी इंस्टॉल करने के बजाय, Chat की बेहतर सेवा का इस्तेमाल करें.
पुष्टि करना
Chat API को कॉल करने के लिए, पुष्टि करना ज़रूरी है. Chat API के हर तरीके के लिए, उपयोगकर्ता की पुष्टि (किसी उपयोगकर्ता की ओर से कार्रवाइयां करने या डेटा ऐक्सेस करने के लिए) या ऐप्लिकेशन की पुष्टि (Chat ऐप्लिकेशन के तौर पर कार्रवाइयां करने या डेटा ऐक्सेस करने के लिए) करना ज़रूरी है. कुछ तरीकों से, उपयोगकर्ता की पुष्टि और ऐप्लिकेशन की पुष्टि, दोनों की जा सकती है.
Chat में पुष्टि करने के बारे में ज़्यादा जानने के लिए, पुष्टि करने की खास जानकारी देखें.