Trang này được dịch bởi Cloud Translation API.

Liệt kê không gian

Hướng dẫn này giải thích cách sử dụng tài nguyên list trên tài nguyên Space của API Google Chat để liệt kê các không gian. Không gian danh sách trả về một giá trị được phân trang, có thể lọc danh sách không gian.

Chiến lược phát hành đĩa đơ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 hai người dùng hoặc một người dùng và ứ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à Ứng dụng nhắn tin.
Không gian được đặt tên là những địa điểm cố định nơi mọi người gửi tin nhắn, chia sẻ tệp, và cộng tác.

Không gian danh sách chứa xác thực ứng dụng liệt kê các không gian mà ứng dụng Chat có quyền truy cập. Danh sách không gian với Xác thực người dùng liệt kê các không gian mà người dùng đã xác thực có quyền truy cập.

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

Python

Doanh nghiệp Tài khoản Google Workspace có quyền truy cập vào Google Chat.

Python 3.6 trở lên
Công cụ quản lý gói pip
Thư viện ứng dụng mới nhất của Google. Cách cài đặt hoặc cập nhật các tính năng này: chạy lệnh sau trong giao diện dòng lệnh:
```
pip3 install --upgrade google-api-python-client google-auth-oauthlib
```

Thiết lập môi trường:
- Tạo một dự án trên Google Cloud.
- Định cấu hình màn hình xin phép bằng OAuth.
- Bật và định cấu hình API Google Chat bằng tên, biểu tượng và nội dung mô tả cho ứng dụng Chat.
Chọn phạm vi uỷ quyền.

Node.js

Doanh nghiệp Tài khoản Google Workspace có quyền truy cập vào Google Chat.

Node.js 14 trở lên
npm công cụ quản lý gói
Thư viện ứng dụng mới nhất của Google. Cách cài đặt hoặc cập nhật các tính năng này: chạy lệnh sau trong giao diện dòng lệnh:
```
npm install @google-cloud/local-auth @googleapis/chat
```

Thiết lập môi trường:
- Tạo một dự án trên Google Cloud.
- Định cấu hình màn hình xin phép bằng OAuth.
- Bật và định cấu hình API Google Chat bằng tên, biểu tượng và nội dung mô tả cho ứng dụng Chat.
Chọn phạm vi uỷ quyền.

Liệt kê các không gian có xác thực người dùng

Để liệt kê các không gian trong Google Chat, hãy truyền những thông tin sau vào yêu cầu:

Bằng xác thực người dùng, chỉ định phạm vi uỷ quyền chat.spaces.readonly hoặc chat.spaces.
Gọi Phương thức list trên Space tài nguyên.

Ví dụ sau đây liệt kê các không gian có tên và cuộc trò chuyện nhóm (nhưng không trực tiếp) thư được lọc ra) hiển thị cho người dùng đã xác thực:

Python

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

Đưa mã sau vào chat_space_list.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 lists named spaces and group chats (but not direct messages)
    visible to the authenticated user.
    '''

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

          # An optional filter that returns named spaces or unnamed group chats,
          # but not direct messages (DMs).
          filter='spaceType = "SPACE" OR spaceType = "GROUP_CHAT"'

      ).execute()

    # Prints the returned list of spaces.
    print(result)

if __name__ == '__main__':
    main()

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

Node.js

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

Đưa mã sau vào list-spaces.js:

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

/**
* List Chat spaces.
* @return {!Promise<!Object>}
*/
async function listSpaces() {
  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.list({
    filter: 'spaceType = "SPACE" OR spaceType = "GROUP_CHAT"'
  });
}

listSpaces().then(console.log);

Trong thư mục đang hoạt động, hãy chạy mẫu:
```
node list-spaces.js
```

API Chat trả về một nhiều không gian được đặt tên và cuộc trò chuyện nhóm được phân trang.