Mời hoặc thêm người dùng, nhóm trên Google Groups hoặc ứng dụng Google Chat vào một không gian

Python

• Python 3.6 trở lên
• Công cụ quản lý gói pip

• Các thư viện ứng dụng mới nhất của Google dành cho Python. Để cài đặt hoặc cập nhật các trình mô phỏng, hãy chạy lệnh sau trong giao diện dòng lệnh:

  pip3 install --upgrade google-api-python-client google-auth-oauthlib
  

• Một dự án trên Google Cloud đã bật và định cấu hình API Google Chat. Để biết các bước, hãy xem bài viết Tạo ứng dụng Google Chat.

• Đã định cấu hình uỷ quyền cho ứng dụng Chat. Để tạo gói thành viên, bạn cần Xác thực người dùng với phạm vi uỷ quyền chat.memberships hoặc chat.memberships.app.

Node.js

• Node.js và npm

• Các thư viện ứng dụng mới nhất của Google dành cho Node.js. Để cài đặt các trình xử lý sự kiện đó, hãy chạy lệnh sau trong giao diện dòng lệnh:

  npm install @google-cloud/local-auth @googleapis/chat
  

• Một dự án trên Google Cloud đã bật và định cấu hình API Google Chat. Để biết các bước, hãy xem bài viết Tạo ứng dụng Google Chat.

• Đã định cấu hình uỷ quyền cho ứng dụng Chat. Để tạo gói thành viên, bạn cần Xác thực người dùng với phạm vi uỷ quyền chat.memberships hoặc chat.memberships.app.

Python

1. Trong thư mục đang làm việc, hãy tạo một tệp có tên chat_membership_user_create.py.

2. Đưa mã sau vào chat_membership_user_create.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.memberships"]
   
   def main():
       '''
       Authenticates with Chat API via user credentials,
       then adds a user to a Chat space by creating a membership.
       '''
   
       # 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().members().create(
   
           # The space in which to create a membership.
           parent = 'spaces/SPACE',
   
           # Specify which user the membership is for.
           body = {
             'member': {
               'name':'users/USER',
               'type': 'HUMAN'
             }
           }
   
       ).execute()
   
       # Prints details about the created membership.
       print(result)
   
   if __name__ == '__main__':
       main()
   

3. Trong mã, thay thế các nội dung sau:

   • SPACE: tên không gian mà bạn có thể lấy từ phương thức spaces.list trong API Chat hoặc từ URL của không gian.

   • USER: mã nhận dạng người dùng.

4. Trong thư mục đang làm việc, hãy tạo và chạy mẫu:

   python3 chat_membership_user_create.py
   

Node.js

1. Trong thư mục đang làm việc, hãy tạo một tệp có tên add-user-to-space.js.

2. Đưa mã sau vào add-user-to-space.js:

   const chat = require('@googleapis/chat');
   const {authenticate} = require('@google-cloud/local-auth');
   
   /**
   * Adds the user to the Chat space.
   * @return {!Promise<!Object>}
   */
   async function addUserToSpace() {
     const scopes = [
       'https://www.googleapis.com/auth/chat.memberships',
     ];
   
     const authClient =
         await authenticate({scopes, keyfilePath: 'client_secrets.json'});
   
     const chatClient = await chat.chat({version: 'v1', auth: authClient});
   
     return await chatClient.spaces.members.create({
       parent: 'spaces/SPACE',
       requestBody: {member: {name: 'users/USER', type: 'HUMAN'}}
     });
   }
   
   addUserToSpace().then(console.log);
   

3. Trong mã, thay thế các nội dung sau:

   • SPACE: tên không gian mà bạn có thể lấy từ phương thức spaces.list trong API Chat hoặc từ URL của không gian.

   • USER: mã nhận dạng người dùng.

4. Trong thư mục đang làm việc, hãy chạy mẫu:

   node add-user-to-space.js
   

Python

1. Trong thư mục đang làm việc, hãy tạo một tệp có tên chat_membership_group_create.py.

2. Đưa mã sau vào chat_membership_group_create.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.memberships"]
   
   def main():
       '''
       Authenticates with Chat API via user credentials,
       then adds a group to a Chat space by creating a membership.
       '''
   
       # 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().members().create(
   
           # The named space in which to create a membership.
           parent = 'spaces/SPACE',
   
           # Specify which group the membership is for.
           body = {
             'groupMember': {
               'name':'groups/GROUP',
             }
           }
   
       ).execute()
   
       # Prints details about the created membership.
       print(result)
   
   if __name__ == '__main__':
       main()
   

3. Trong mã, thay thế các nội dung sau:

   • SPACE: tên không gian mà bạn có thể lấy từ phương thức spaces.list trong API Chat hoặc từ URL của không gian.

   • GROUP: một mã nhóm.

4. Trong thư mục đang làm việc, hãy tạo và chạy mẫu:

   python3 chat_membership_group_create.py
   

Node.js

1. Trong thư mục đang làm việc, hãy tạo một tệp có tên add-group-to-space.js.

2. Đưa mã sau vào add-group-to-space.js:

   const chat = require('@googleapis/chat');
   const {authenticate} = require('@google-cloud/local-auth');
   
   /**
   * Adds the group to the Chat space.
   * @return {!Promise<!Object>}
   */
   async function addUserToSpace() {
     const scopes = [
       'https://www.googleapis.com/auth/chat.memberships',
     ];
   
     const authClient =
         await authenticate({scopes, keyfilePath: 'client_secrets.json'});
   
     const chatClient = await chat.chat({version: 'v1', auth: authClient});
   
     return await chatClient.spaces.members.create({
       parent: 'spaces/SPACE',
       requestBody: {groupMember: {name: 'groups/GROUP'}}
     });
   }
   
   addUserToSpace().then(console.log);
   

3. Trong mã, thay thế các nội dung sau:

   • SPACE: tên không gian mà bạn có thể lấy từ phương thức spaces.list trong API Chat hoặc từ URL của không gian.

   • GROUP: một mã nhóm.

4. Trong thư mục đang làm việc, hãy chạy mẫu:

   node add-group-to-space.js
   

Python

1. Trong thư mục đang làm việc, hãy tạo một tệp có tên chat_membership_app_create.py.

2. Đưa mã sau vào chat_membership_app_create.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.memberships.app"]
   
   def main():
       '''
       Authenticates with Chat API via user credentials,
       then adds the Chat app to 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().members().create(
   
           # The space in which to create a membership.
           parent = 'spaces/SPACE',
   
           # Set the Chat app as the entity that gets added to the space.
           # 'app' is an alias for the Chat app calling the API.
           body = {
               'member': {
                 'name':'users/app',
                 'type': 'BOT'
               }
           }
   
       ).execute()
   
       # Prints details about the created membership.
       print(result)
   
   if __name__ == '__main__':
       main()
   

3. Trong đoạn mã, hãy thay thế SPACE bằng tên không gian mà bạn có thể lấy từ phương thức spaces.list trong API Chat hoặc từ URL của không gian.

4. Trong thư mục đang làm việc, hãy tạo và chạy mẫu:

   python3 chat_membership_app_create.py
   

Node.js

1. Trong thư mục đang làm việc, hãy tạo một tệp có tên add-app-to-space.js.

2. Đưa mã sau vào add-app-to-space.js:

   const chat = require('@googleapis/chat');
   const {authenticate} = require('@google-cloud/local-auth');
   
   /**
   * Adds the app to the Chat space.
   * @return {!Promise<!Object>}
   */
   async function addAppToSpace() {
     const scopes = [
       'https://www.googleapis.com/auth/chat.memberships.app',
     ];
   
     const authClient =
         await authenticate({scopes, keyfilePath: 'client_secrets.json'});
   
     const chatClient = await chat.chat({version: 'v1', auth: authClient});
   
     return await chatClient.spaces.members.create({
       parent: 'spaces/SPACE',
       requestBody: {member: {name: 'users/app', type: 'BOT'}}
     });
   }
   
   addAppToSpace().then(console.log);
   

3. Trong đoạn mã, hãy thay thế SPACE bằng tên không gian mà bạn có thể lấy từ phương thức spaces.list trong API Chat hoặc từ URL của không gian.

4. Trong thư mục đang làm việc, hãy chạy mẫu:

   node add-app-to-space.js