इस पेज का अनुवाद Cloud Translation API से किया गया है.

किसी स्पेस के बारे में जानकारी पाना

इस गाइड में बताया गया है कि स्पेस के डिसप्ले नेम, ब्यौरे, और दिशा-निर्देशों जैसी जानकारी देखने के लिए, Google Chat API के Space संसाधन पर get तरीके का इस्तेमाल कैसे करें.

Space रिसॉर्स ऐसी जगह दिखाता है जहां लोग और Chat ऐप्लिकेशन, मैसेज भेज सकते हैं, फ़ाइलें शेयर कर सकते हैं, और साथ मिलकर काम कर सकते हैं. स्पेस कई तरह के होते हैं:

डायरेक्ट मैसेज (DM) दो उपयोगकर्ताओं या एक उपयोगकर्ता और एक Chat ऐप्लिकेशन के बीच होने वाली बातचीत होते हैं.
ग्रुप चैट, तीन या उससे ज़्यादा उपयोगकर्ताओं और चैट ऐप्लिकेशन के बीच की बातचीत होती है.
नाम वाले स्पेस वे जगहें होती हैं जहां लोग मैसेज भेजते हैं, फ़ाइलें शेयर करते हैं, और साथ मिलकर काम करते हैं.

ऐप्लिकेशन की पुष्टि करने की सुविधा से पुष्टि करने पर, Chat ऐप्लिकेशन को ऐसे स्पेस मिलते हैं जिनका ऐक्सेस Google Chat में Chat ऐप्लिकेशन को होता है. उदाहरण के लिए, ऐसे स्पेस जिनका ऐक्सेस वह ऐप्लिकेशन के पास होता है. उपयोगकर्ता की पुष्टि करने की मदद से पुष्टि करने पर, आपको ऐसे स्पेस मिलते हैं जिनका ऐक्सेस पुष्टि किए गए उपयोगकर्ता के पास है.

ज़रूरी शर्तें

Python

Python 3.6 या इससे नया वर्शन
pip पैकेज मैनेजमेंट टूल
Python के लिए नई Google क्लाइंट लाइब्रेरी. उन्हें इंस्टॉल या अपडेट करने के लिए, अपने कमांड-लाइन इंटरफ़ेस में नीचे दिया गया कमांड चलाएं:
```
pip3 install --upgrade google-api-python-client google-auth-oauthlib google-auth
```
ऐसा Google Cloud प्रोजेक्ट जिसमें Google Chat API चालू हो और उसे कॉन्फ़िगर किया गया हो. तरीका जानने के लिए, Google Chat ऐप्लिकेशन बनाना देखें.
Chat ऐप्लिकेशन के लिए अनुमति कॉन्फ़िगर कर दी गई है. स्पेस पाने के लिए, पुष्टि करने के ये दोनों तरीके इस्तेमाल किए जा सकते हैं:
- chat.spaces.readonly या chat.spaces के अनुमति वाले दायरे के साथ उपयोगकर्ता की पुष्टि करना.
- chat.bot के अनुमति वाले दायरे के साथ ऐप्लिकेशन की पुष्टि करना.

Node.js

Node.js और npm
Node.js के लिए नई Google क्लाइंट लाइब्रेरी. उन्हें इंस्टॉल करने के लिए, अपने कमांड-लाइन इंटरफ़ेस में इस कमांड को चलाएं:
```
npm install @google-cloud/local-auth @googleapis/chat
```
ऐसा Google Cloud प्रोजेक्ट जिसमें Google Chat API चालू हो और उसे कॉन्फ़िगर किया गया हो. तरीका जानने के लिए, Google Chat ऐप्लिकेशन बनाना देखें.
Chat ऐप्लिकेशन के लिए अनुमति कॉन्फ़िगर कर दी गई है. स्पेस पाने के लिए, पुष्टि करने के ये दोनों तरीके इस्तेमाल किए जा सकते हैं:
- chat.spaces.readonly या chat.spaces के अनुमति वाले दायरे के साथ उपयोगकर्ता की पुष्टि करना.
- chat.bot के अनुमति वाले दायरे के साथ ऐप्लिकेशन की पुष्टि करना.

कोई स्पेस खरीदें

Google Chat में स्पेस पाने के लिए, अपने अनुरोध में यह जानकारी दें:

ऐप्लिकेशन की पुष्टि करने की सुविधा के साथ, chat.bot के लिए अनुमति का दायरा बताएं. उपयोगकर्ता की पुष्टि करने की सुविधा के साथ, chat.spaces.readonly या chat.spaces के लिए अनुमति का दायरा बताएं.
Space रिसॉर्स पर get वाला तरीका इस्तेमाल करें. इससे आपको स्पेस का name पास करना होगा. स्पेस का नाम, Google Chat के संसाधन या स्पेस के यूआरएल से पाएं.

उपयोगकर्ता की पुष्टि करने के बाद, स्पेस की जानकारी पाना

उपयोगकर्ता की पुष्टि करने की सुविधा से स्पेस की जानकारी पाने का तरीका जानें:

Python

अपनी वर्किंग डायरेक्ट्री में, chat_space_get_user.py नाम की एक फ़ाइल बनाएं.

chat_space_get_user.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.readonly"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then gets details about a specified space.
    '''

    # 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().get(

          # The space to get.
          #
          # 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'

      ).execute()

    # Prints details about the space.
    print(result)

if __name__ == '__main__':
    main()

कोड में, SPACE की जगह स्पेस का नाम डालें. इसे स्पेस के यूआरएल या Chat API में, spaces.list तरीके से लिया जा सकता है.
अपनी वर्किंग डायरेक्ट्री में, यह सैंपल बनाएं और चलाएं:
```
python3 chat_space_get_user.py
```

Node.js

अपनी वर्किंग डायरेक्ट्री में, get-space.js नाम की एक फ़ाइल बनाएं.

get-space.js में यह कोड शामिल करें:

const chat = require('@googleapis/chat');
const {authenticate} = require('@google-cloud/local-auth');

/**
* Gets details about a Chat space by name.
* @return {!Object}
*/
async function getSpace() {
  const scopes = [
    'https://www.googleapis.com/auth/chat.spaces.readonly',
  ];

  const authClient =
      await authenticate({scopes, keyfilePath: 'client_secrets.json'});

  const chatClient = await chat.chat({version: 'v1', auth: authClient});

  return await chatClient.spaces.get({name: 'spaces/SPACE'});
}

getSpace().then(console.log);

कोड में, SPACE की जगह स्पेस का नाम डालें. इसे स्पेस के यूआरएल या Chat API में, spaces.list तरीके से लिया जा सकता है.
अपनी वर्किंग डायरेक्ट्री में, सैंपल चलाएं:
```
node get-space.js
```

Chat API, Space का एक इंस्टेंस दिखाता है, जिसमें बताए गए स्पेस की जानकारी होती है.

ऐप्लिकेशन की पुष्टि करके, स्पेस की जानकारी पाना

ऐप्लिकेशन की पुष्टि करने के लिए, स्पेस की जानकारी पाने का तरीका नीचे बताया गया है:

Python

अपनी वर्किंग डायरेक्ट्री में, chat_space_get_app.py नाम की एक फ़ाइल बनाएं.

chat_space_get_app.py में यह कोड शामिल करें:

from google.oauth2 import service_account
from apiclient.discovery import build

# Specify required scopes.
SCOPES = ['https://www.googleapis.com/auth/chat.bot']

# Specify service account details.
CREDENTIALS = (
    service_account.Credentials.from_service_account_file('credentials.json')
    .with_scopes(SCOPES)
)

# Build the URI and authenticate with the service account.
chat = build('chat', 'v1', credentials=CREDENTIALS)

# Use the service endpoint to call Chat API.
result = chat.spaces().get(

    # The space to get.
    #
    # 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'

).execute()

print(result)

कोड में, SPACE की जगह स्पेस का नाम डालें. इसे स्पेस के यूआरएल या Chat API में, spaces.list() तरीके से लिया जा सकता है.
अपनी वर्किंग डायरेक्ट्री में, यह सैंपल बनाएं और चलाएं:
```
python3 chat_space_get_app.py
```

Node.js

अपनी वर्किंग डायरेक्ट्री में, app-get-space.js नाम की एक फ़ाइल बनाएं.

app-get-space.js में यह कोड शामिल करें:

const chat = require('@googleapis/chat');

/**
* Gets details about a Chat space by name.
* @return {!Promise<!Object>}
*/
async function getSpace() {
  const scopes = [
    'https://www.googleapis.com/auth/chat.bot',
  ];

  const auth = new chat.auth.GoogleAuth({
    scopes,
    keyFilename: 'credentials.json',
  });

  const authClient = await auth.getClient();
  const chatClient = await chat.chat({version: 'v1', auth: authClient});

  return await chatClient.spaces.get({name: 'spaces/SPACE'});
}

getSpace().then(console.log);

कोड में, SPACE की जगह स्पेस का नाम डालें. इसे स्पेस के यूआरएल या Chat API में, spaces.list तरीके से लिया जा सकता है.
अपनी वर्किंग डायरेक्ट्री में, सैंपल चलाएं:
```
node app-get-space.js
```

Chat API, Space का एक इंस्टेंस दिखाता है, जिसमें बताए गए स्पेस की जानकारी होती है.

किसी स्पेस के बारे में जानकारी पाना

ज़रूरी शर्तें

Python

Node.js

कोई स्पेस खरीदें

उपयोगकर्ता की पुष्टि करने के बाद, स्पेस की जानकारी पाना

Python

Node.js

ऐप्लिकेशन की पुष्टि करके, स्पेस की जानकारी पाना

Python

Node.js

मिलते-जुलते विषय