یک فضا ایجاد کنید

این راهنما نحوه استفاده از روش create در منبع Space API Google Chat برای ایجاد یک فضای نامگذاری شده توضیح می دهد.

منبع Space مکانی را نشان می‌دهد که در آن افراد و برنامه‌های چت می‌توانند پیام ارسال کنند، فایل‌ها را به اشتراک بگذارند و با هم همکاری کنند. چند نوع فضا وجود دارد:

  • پیام‌های مستقیم (DM) مکالمات بین دو کاربر یا یک کاربر و یک برنامه چت هستند.
  • چت گروهی مکالمه بین سه یا چند کاربر و برنامه های چت است.
  • فضاهای نام‌گذاری شده مکان‌هایی هستند که افراد در آن پیام می‌فرستند، فایل‌ها را به اشتراک می‌گذارند و همکاری می‌کنند.

فضای نامگذاری شده مکانی است که در آن افراد پیام می فرستند، فایل ها را به اشتراک می گذارند و با هم همکاری می کنند. فضاهای نامگذاری شده می توانند شامل برنامه های چت باشند. فضاهای نامگذاری شده شامل ویژگی‌های اضافی هستند که مکالمات گروهی و پیام‌های مستقیم بدون نام از آن‌ها برخوردار نیستند، مانند مدیران فضا که می‌توانند تنظیمات اداری، توضیحات، و اضافه یا حذف افراد و برنامه‌ها را اعمال کنند. پس از ایجاد یک فضای نامگذاری شده، تنها عضو فضا، کاربر تایید شده است. فضا شامل افراد یا برنامه‌های دیگر نمی‌شود. نه حتی برنامه چت که آن را ایجاد می کند. برای افزودن افراد، با فراخوانی متد create در منبع Member ، عضویت در فضا ایجاد کنید. برای آشنایی با نحوه، به ایجاد عضویت مراجعه کنید.

برای ایجاد فضایی با نام با چند عضو - یک گپ گروهی بدون نام بین سه یا چند نفر، یا یک مکالمه پیام مستقیم بین دو نفر، یا یک شخص و برنامه Chat که Chat API را فرا می‌خواند - به جای آن یک فاصله تنظیم کنید .

پیش نیازها

پایتون

Node.js

فضایی با نام ایجاد کنید

برای ایجاد یک فضای نامگذاری شده، موارد زیر را در درخواست خود وارد کنید:

  • محدوده مجوز chat.spaces.create یا chat.spaces را مشخص کنید.
  • متد create را در منبع Space فراخوانی کنید.
  • spaceType را روی SPACE تنظیم کنید.
  • displayName را روی نام فضای قابل مشاهده توسط کاربر تنظیم کنید. در مثال زیر، displayName روی API-made تنظیم شده است.
  • به صورت اختیاری، سایر ویژگی‌های فضا، مانند spaceDetails (توضیحات قابل مشاهده توسط کاربر و مجموعه‌ای از دستورالعمل‌ها برای فضا) را تنظیم کنید.

در اینجا نحوه ایجاد یک فضای نامگذاری شده آمده است:

پایتون

  1. در پوشه کاری خود، یک فایل با نام chat_space_create_named.py ایجاد کنید.
  2. کد زیر را در chat_space_create_named.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.create"]
    
    def main():
        '''
        Authenticates with Chat API via user credentials,
        then creates a Chat 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().create(
    
          # Details about the space to create.
          body = {
    
            # To create a named space, set spaceType to SPACE.
            'spaceType': 'SPACE',
    
            # The user-visible name of the space.
            'displayName': 'API-made'
          }
    
          ).execute()
    
        # Prints details about the created space.
        print(result)
    
    if __name__ == '__main__':
        main()
    
  3. در پوشه کاری خود، نمونه را بسازید و اجرا کنید:

    python3 chat_space_create_named.py

Node.js

  1. در پوشه کاری خود، یک فایل با نام create-space.js ایجاد کنید.
  2. کد زیر را در create-space.js قرار دهید:

    const chat = require('@googleapis/chat');
    const {authenticate} = require('@google-cloud/local-auth');
    
    /**
    * Creates a new chat space.
    * @return {!Promise<!Object>}
    */
    async function createSpace() {
      const scopes = [
        'https://www.googleapis.com/auth/chat.spaces.create',
      ];
    
      const authClient =
          await authenticate({scopes, keyfilePath: 'client_secrets.json'});
    
      const chatClient = await chat.chat({version: 'v1', auth: authClient});
    
      return await chatClient.spaces.create(
          {requestBody: {spaceType: 'SPACE', displayName: 'API-made'}});
    }
    
    createSpace().then(console.log);
    
  3. در پوشه کاری خود، نمونه را اجرا کنید:

    node create-space.js

فضایی با نام ایجاد می شود. برای پیمایش به فضا، از شناسه منبع فضا برای ساخت URL فضا استفاده کنید. می‌توانید شناسه منبع را از name فضا در بدنه پاسخ Google Chat پیدا کنید. برای مثال، اگر name فضای شما spaces/1234567 است، می‌توانید با استفاده از نشانی اینترنتی زیر به فضا پیمایش کنید: https://mail.google.com/chat/u/0/#chat/space/1234567 .