यह गाइड बताती है कि इसके Space
संसाधन पर patch
तरीके का इस्तेमाल कैसे किया जाए
किसी स्पेस को अपडेट करने के लिए, Google Chat API का इस्तेमाल करें. इसकी विशेषताएं बदलने के लिए स्पेस अपडेट करें
स्पेस, जैसे कि उपयोगकर्ता को दिखने वाला डिसप्ले नेम, ब्यौरा, और दिशा-निर्देश.
कॉन्टेंट बनाने
Space
संसाधन
यह ऐसी जगह दिखाता है जहां लोग और Chat ऐप्लिकेशन मैसेज भेज सकते हैं,
और साथ मिलकर काम करने की सुविधा मिलती है. स्पेस कई तरह के होते हैं:
- डायरेक्ट मैसेज (DM), दो उपयोगकर्ताओं या एक उपयोगकर्ता और एक चैट ऐप्लिकेशन.
- ग्रुप चैट में, तीन या उससे ज़्यादा उपयोगकर्ताओं और चैट ऐप्लिकेशन.
- नाम वाले स्पेस वे स्थायी जगहें होती हैं जहां लोग मैसेज भेजते हैं, फ़ाइलें शेयर करते हैं, और सहयोग करना होगा.
ज़रूरी शर्तें
Python
- कारोबार या एंटरप्राइज़ Google Workspace खाता, जिसके पास इसका ऐक्सेस है Google Chat.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है.
- Google Chat API को चालू और कॉन्फ़िगर करें. आइकॉन और ब्यौरा जोड़ें.
- इंस्टॉल करें Python Google API क्लाइंट लाइब्रेरी.
-
डेस्कटॉप ऐप्लिकेशन के लिए OAuth क्लाइंट आईडी क्रेडेंशियल बनाएं. सैंपल को चलाने के लिए
गाइड के साथ क्रेडेंशियल को
client_secrets.json
नाम वाली JSON फ़ाइल के तौर पर लोकल डायरेक्ट्री.
- अनुमति देने का ऐसा स्कोप चुनें जो उपयोगकर्ता की पुष्टि करने की सुविधा देता हो.
Node.js
- कारोबार या एंटरप्राइज़ Google Workspace खाता, जिसके पास इसका ऐक्सेस है Google Chat.
- अपना एनवायरमेंट सेट अप करें:
- Google Cloud प्रोजेक्ट बनाएं.
- उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth के लिए सहमति दी जाती है.
- Google Chat API को चालू और कॉन्फ़िगर करें. आइकॉन और ब्यौरा जोड़ें.
- इंस्टॉल करें Node.js Google API क्लाइंट लाइब्रेरी.
-
डेस्कटॉप ऐप्लिकेशन के लिए OAuth क्लाइंट आईडी क्रेडेंशियल बनाएं. सैंपल को चलाने के लिए
गाइड के साथ क्रेडेंशियल को
client_secrets.json
नाम वाली JSON फ़ाइल के तौर पर लोकल डायरेक्ट्री.
- अनुमति देने का ऐसा स्कोप चुनें जो उपयोगकर्ता की पुष्टि करने की सुविधा देता हो.
स्पेस को अपडेट करना
Google Chat में किसी मौजूदा स्पेस को अपडेट करने के लिए, यह जानकारी दें आपके अनुरोध में:
chat.spaces
की अनुमति के दायरे के बारे में बताएं.- कॉल करें
patch
तरीकाSpace
संसाधन पर जाएं. तय सीमा में आपने स्पेस केname
फ़ील्डupdateMask
का इस्तेमाल करने का विकल्प चुना है. एक या उससे ज़्यादा फ़ील्ड को अपडेट करना होगा, औरbody
को स्पेस की अपडेट की गई जानकारी के साथ अपडेट किया गया है.
हालांकि, डिसप्ले नेम, स्पेस का टाइप, इतिहास की स्थिति, और वगैरह को कॉपी करने का विकल्प है. वे सभी फ़ील्ड देखने के लिए जिन्हें अपडेट किया जा सकता है, यहां देखें रेफ़रंस दस्तावेज़.
किसी मौजूदा स्पेस के spaceDetails
फ़ील्ड को अपडेट करने का तरीका यहां बताया गया है:
Python
- अपनी वर्किंग डायरेक्ट्री में,
chat_space_update.py
नाम की फ़ाइल बनाएं. chat_space_update.py
में यह कोड शामिल करें:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build # Define your app's authorization scopes. # When modifying these scopes, delete the file token.json, if it exists. SCOPES = ["https://www.googleapis.com/auth/chat.spaces"] def main(): ''' Authenticates with Chat API via user credentials, then updates the specified space description and guidelines. ''' # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file( 'client_secrets.json', SCOPES) creds = flow.run_local_server() # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds) # Use the service endpoint to call Chat API. result = chat.spaces().patch( # The space to update, and the updated space details. # # Replace {space} with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. name='spaces/SPACE', updateMask='spaceDetails', body={ 'spaceDetails': { 'description': 'This description was updated with Chat API!', 'guidelines': 'These guidelines were updated with Chat API!' } } ).execute() # Prints details about the updated space. print(result) if __name__ == '__main__': main()
कोड में,
SPACE
को एक स्पेस नाम से बदलें, जो तो आपको यहां सेspaces.list
तरीका या स्पेस के यूआरएल से मिलेगी.अपनी वर्किंग डायरेक्ट्री में, सैंपल बनाएं और चलाएं:
python3 chat_space_update.py
Node.js
- अपनी वर्किंग डायरेक्ट्री में,
update-space.js
नाम की फ़ाइल बनाएं. update-space.js
में यह कोड शामिल करें:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Updates a Chat space with the description and guidelines. * @return {!Promise<!Object>} */ async function updateSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.spaces', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.patch({ name: 'spaces/SPACE', updateMask: 'spaceDetails', requestBody: { spaceDetails: { description: 'This description was updated with Chat API!', guidelines: 'These guidelines were updated with Chat API!' }, } }); } updateSpace().then(console.log);
कोड में,
SPACE
को एक स्पेस नाम से बदलें, जो तो आपको यहां सेspaces.list
तरीका या स्पेस के यूआरएल से मिलेगी.अपनी वर्किंग डायरेक्ट्री में, सैंपल चलाएं:
node update-space.js
Google Chat API,
अपडेट दिखाने वाला Space
संसाधन.
मिलते-जुलते विषय
- किसी स्पेस के बारे में जानकारी पाना.
- स्पेस की सूची बनाना.
- किसी स्पेस को मिटाना.
- स्पेस सेट अप करना.
- डायरेक्ट मैसेज वाला स्पेस ढूंढें.
- स्पेस को कुछ खास लोगों के लिए उपलब्ध कराना.