Tạo không gian

Hướng dẫn này giải thích cách sử dụng phương thức create trên tài nguyên Space của API Google Chat để tạo không gian được đặt tên.

Tài nguyên Space đại diện cho nơi mọi người và các ứng dụng trong Chat có thể gửi tin nhắn, chia sẻ tệp và cộng tác. Có một số loại không gian:

  • Tin nhắn trực tiếp (DM) là các cuộc trò chuyện giữa 2 người dùng hoặc một người dùng với một ứng dụng Chat.
  • Cuộc trò chuyện nhóm là các cuộc trò chuyện giữa ba người dùng trở lên và các ứng dụng trong Chat.
  • Không gian được đặt tên là các nơi cố định để mọi người gửi tin nhắn, chia sẻ tệp và cộng tác.

Không gian được đặt tên là nơi mọi người gửi tin nhắn, chia sẻ tệp và cộng tác. Không gian được đặt tên có thể bao gồm các ứng dụng trong Chat. Không gian được đặt tên bao gồm các tính năng bổ sung mà cuộc trò chuyện nhóm chưa đặt tên và tin nhắn trực tiếp không có, chẳng hạn như người quản lý không gian có thể áp dụng các chế độ cài đặt quản trị, nội dung mô tả cũng như thêm hoặc xoá người dùng và ứng dụng. Sau khi tạo không gian được đặt tên, thành viên duy nhất của không gian là người dùng được xác thực. Không gian này không bao gồm người hoặc ứng dụng khác, thậm chí không có ứng dụng Chat tạo ra không gian đó. Để thêm người khác, hãy tạo thành viên trong không gian bằng cách gọi phương thức create trên tài nguyên Member. Để tìm hiểu cách thực hiện, hãy xem bài viết Tạo gói thành viên.

Để tạo một không gian được đặt tên có nhiều thành viên – một cuộc trò chuyện nhóm chưa đặt tên giữa 3 người trở lên, một cuộc trò chuyện bằng tin nhắn trực tiếp giữa hai người, hoặc một người và ứng dụng Chat gọi API Chat – hãy thiết lập một không gian.

Điều kiện tiên quyết

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 thành phần này, 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à thiết lập 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 hoạt động uỷ quyền cho ứng dụng Chat. Việc tạo không gian cần phải Xác thực người dùng trong phạm vi uỷ quyền chat.spaces.create hoặc chat.spaces.

Node.js

  • Node.js và npm

  • Thư viện ứng dụng mới nhất của Google dành cho Node.js. Để cài đặt các công cụ này, hãy chạy lệnh sau trong giao diện dòng lệnh của bạn:

    npm install @google-cloud/local-auth @googleapis/chat
  • Một dự án trên Google Cloud đã bật và thiết lập 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 hoạt động uỷ quyền cho ứng dụng Chat. Việc tạo không gian cần phải Xác thực người dùng trong phạm vi uỷ quyền chat.spaces.create hoặc chat.spaces.

Tạo không gian được đặt tên

Để tạo không gian được đặt tên, hãy chuyển nội dung sau vào yêu cầu của bạn:

  • Chỉ định phạm vi uỷ quyền chat.spaces.create hoặc chat.spaces.
  • Gọi phương thức create trên tài nguyên Space.
  • Đặt spaceType thành SPACE.
  • Đặt displayName thành tên không gian mà người dùng nhìn thấy. Trong ví dụ sau, displayName được đặt thành API-made.
  • Nếu muốn, bạn có thể đặt các thuộc tính khác của không gian, chẳng hạn như spaceDetails (nội dung mô tả mà người dùng nhìn thấy và bộ nguyên tắc dành cho không gian).

Dưới đây là cách tạo không gian được đặt tên:

Python

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

  2. Đưa mã sau vào 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 membership.
    print(result)

if __name__ == '__main__':
    main()

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

    python3 chat_space_create_named.py

Node.js

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

  2. Đưa mã sau vào 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. Trong thư mục đang làm việc của bạn, hãy chạy mẫu:

    node create-space.js

Một không gian được đặt tên sẽ được tạo. Để điều hướng đến không gian, hãy sử dụng mã nhận dạng tài nguyên của không gian để tạo URL của không gian đó. Bạn có thể tìm thấy mã tài nguyên trong không gian name trong nội dung phản hồi của Google Chat. Ví dụ: nếu name của không gian là spaces/1234567, bạn có thể điều hướng đến không gian đó bằng URL sau: https://mail.google.com/chat/u/0/#chat/space/1234567.