Hướng dẫn này giải thích cách sử dụng phương thức get()
trên tài nguyên Membership
của Google Chat API để biết thông tin chi tiết về một thành viên trong không gian.
Nếu là quản trị viên Google Workspace, bạn có thể gọi phương thức get()
để truy xuất thông tin chi tiết về mọi thành viên trong tổ chức Google Workspace của mình.
Tài nguyên Membership
cho biết liệu người dùng là con người hay ứng dụng Google Chat có được mời, có tham gia hay không tham gia một không gian.
Xác thực bằng xác thực ứng dụng cho phép một ứng dụng Chat lấy thông tin thành viên từ những không gian mà ứng dụng đó có quyền truy cập trong Google Chat (ví dụ: những không gian mà ứng dụng đó là thành viên), nhưng không bao gồm thông tin thành viên của ứng dụng Chat, kể cả thông tin thành viên của chính ứng dụng đó. Xác thực bằng xác thực người dùng sẽ trả về thông tin thành viên của những 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
Node.js
- Tài khoản Google Workspace Business hoặc Enterprise có quyền truy cập vào Google 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 đồng ý OAuth.
- Bật và định cấu hình Google Chat API bằng tên, biểu tượng và nội dung mô tả cho ứng dụng Chat của bạn.
- Cài đặt Thư viện ứng dụng Cloud Node.js.
- Tạo thông tin đăng nhập để truy cập dựa trên cách bạn muốn xác thực trong yêu cầu Google Chat API:
- Để xác thực với tư cách là người dùng Chat, hãy tạo thông tin xác thực mã ứng dụng OAuth và lưu thông tin xác thực dưới dạng tệp JSON có tên
credentials.json
vào thư mục cục bộ của bạn. - Để xác thực dưới dạng ứng dụng Chat, hãy tạo thông tin đăng nhập tài khoản dịch vụ và lưu thông tin đăng nhập dưới dạng tệp JSON có tên là
credentials.json
.
- Để xác thực với tư cách là người dùng Chat, hãy tạo thông tin xác thực mã ứng dụng OAuth và lưu thông tin xác thực dưới dạng tệp JSON có tên
- Chọn phạm vi uỷ quyền dựa trên việc bạn muốn xác thực với tư cách là người dùng hay ứng dụng Chat.
- Một không gian trên Google Chat mà người dùng đã xác thực hoặc ứng dụng Chat gọi là thành viên. Để xác thực dưới dạng ứng dụng Chat, hãy thêm ứng dụng Chat vào không gian.
Python
- Tài khoản Google Workspace Business hoặc Enterprise có quyền truy cập vào Google 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 đồng ý OAuth.
- Bật và định cấu hình Google Chat API bằng tên, biểu tượng và nội dung mô tả cho ứng dụng Chat của bạn.
- Cài đặt Thư viện ứng dụng đám mây Python.
- Tạo thông tin đăng nhập để truy cập dựa trên cách bạn muốn xác thực trong yêu cầu Google Chat API:
- Để xác thực với tư cách là người dùng Chat, hãy tạo thông tin xác thực mã ứng dụng OAuth và lưu thông tin xác thực dưới dạng tệp JSON có tên
credentials.json
vào thư mục cục bộ của bạn. - Để xác thực dưới dạng ứng dụng Chat, hãy tạo thông tin đăng nhập tài khoản dịch vụ và lưu thông tin đăng nhập dưới dạng tệp JSON có tên là
credentials.json
.
- Để xác thực với tư cách là người dùng Chat, hãy tạo thông tin xác thực mã ứng dụng OAuth và lưu thông tin xác thực dưới dạng tệp JSON có tên
- Chọn phạm vi uỷ quyền dựa trên việc bạn muốn xác thực với tư cách là người dùng hay ứng dụng Chat.
- Một không gian trên Google Chat mà người dùng đã xác thực hoặc ứng dụng Chat gọi là thành viên. Để xác thực dưới dạng ứng dụng Chat, hãy thêm ứng dụng Chat vào không gian.
Java
- Tài khoản Google Workspace Business hoặc Enterprise có quyền truy cập vào Google 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 đồng ý OAuth.
- Bật và định cấu hình Google Chat API bằng tên, biểu tượng và nội dung mô tả cho ứng dụng Chat của bạn.
- Cài đặt Thư viện ứng dụng đám mây Java.
- Tạo thông tin đăng nhập để truy cập dựa trên cách bạn muốn xác thực trong yêu cầu Google Chat API:
- Để xác thực với tư cách là người dùng Chat, hãy tạo thông tin xác thực mã ứng dụng OAuth và lưu thông tin xác thực dưới dạng tệp JSON có tên
credentials.json
vào thư mục cục bộ của bạn. - Để xác thực dưới dạng ứng dụng Chat, hãy tạo thông tin đăng nhập tài khoản dịch vụ và lưu thông tin đăng nhập dưới dạng tệp JSON có tên là
credentials.json
.
- Để xác thực với tư cách là người dùng Chat, hãy tạo thông tin xác thực mã ứng dụng OAuth và lưu thông tin xác thực dưới dạng tệp JSON có tên
- Chọn phạm vi uỷ quyền dựa trên việc bạn muốn xác thực với tư cách là người dùng hay ứng dụng Chat.
- Một không gian trên Google Chat mà người dùng đã xác thực hoặc ứng dụng Chat gọi là thành viên. Để xác thực dưới dạng ứng dụng Chat, hãy thêm ứng dụng Chat vào không gian.
Apps Script
- Tài khoản Google Workspace Business hoặc Enterprise có quyền truy cập vào Google 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 đồng ý OAuth.
- Bật và định cấu hình Google Chat API bằng tên, biểu tượng và nội dung mô tả cho ứng dụng Chat của bạn.
- Tạo một dự án Apps Script độc lập và bật Dịch vụ Chat nâng cao.
- Trong hướng dẫn này, bạn phải sử dụng quy trình xác thực người dùng hoặc ứng dụng. Để xác thực dưới dạng ứng dụng Chat, hãy tạo thông tin đăng nhập tài khoản dịch vụ. Để biết các bước, hãy xem phần Xác thực và uỷ quyền dưới dạng ứng dụng Google Chat.
- Chọn phạm vi uỷ quyền dựa trên việc bạn muốn xác thực với tư cách là người dùng hay ứng dụng Chat.
- Một không gian trên Google Chat mà người dùng đã xác thực hoặc ứng dụng Chat gọi là thành viên. Để xác thực dưới dạng ứng dụng Chat, hãy thêm ứng dụng Chat vào không gian.
Xem thông tin chi tiết về gói thành viên
Để biết thông tin chi tiết về một thành viên trong Google Chat, hãy truyền các thông tin sau trong yêu cầu của bạn:
- Với xác thực ứng dụng, hãy chỉ định phạm vi uỷ quyền
chat.bot
. Với xác thực người dùng, hãy chỉ định phạm vi uỷ quyềnchat.memberships.readonly
hoặcchat.memberships
. Tốt nhất là bạn nên chọn phạm vi hạn chế nhất nhưng vẫn cho phép ứng dụng của bạn hoạt động. - Gọi phương thức
GetMembership()
. - Truyền
name
của gói thành viên để nhận. Lấy tên thành viên từ tài nguyên thành viên của Google Chat.
Mua gói hội viên bằng cách xác thực người dùng
Sau đây là cách mua gói thành viên bằng tính năng xác thực người dùng:
Node.js
Python
Java
Apps Script
Để chạy mẫu này, hãy thay thế các nội dung sau:
SPACE_NAME
: mã nhận dạng từname
của không gian. Bạn có thể lấy mã nhận dạng bằng cách gọi phương thứcListSpaces()
hoặc từ URL của không gian.MEMBER_NAME
: mã nhận dạng từname
của thành viên. Bạn có thể lấy mã nhận dạng bằng cách gọi phương thứcListMemberships()
.
Chat API trả về một thực thể Membership
nêu chi tiết về thành viên được chỉ định.
Mua gói hội viên bằng phương thức xác thực ứng dụng
Sau đây là cách mua gói thành viên bằng phương thức xác thực ứng dụng:
Node.js
Python
Java
Apps Script
Để chạy mẫu này, hãy thay thế các nội dung sau:
SPACE_NAME
: mã nhận dạng từname
của không gian. Bạn có thể lấy mã nhận dạng bằng cách gọi phương thứcListSpaces()
hoặc từ URL của không gian.MEMBER_NAME
: mã nhận dạng từname
của thành viên. Bạn có thể lấy mã nhận dạng bằng cách gọi phương thứcListMemberships()
.
Chat API trả về một thực thể Membership
nêu chi tiết về thành viên được chỉ định.
Xem thông tin chi tiết về gói thành viên với tư cách là quản trị viên Google Workspace
Nếu là quản trị viên Google Workspace, bạn có thể gọi phương thức GetMembership()
để truy xuất thông tin chi tiết về tư cách thành viên của bất kỳ người dùng nào trong tổ chức Google Workspace của bạn.
Để gọi phương thức này với tư cách là quản trị viên Google Workspace, hãy làm như sau:
- Gọi phương thức bằng cách xác thực người dùng và chỉ định một phạm vi uỷ quyền hỗ trợ việc gọi phương thức bằng đặc quyền quản trị viên.
- Trong yêu cầu, hãy chỉ định tham số truy vấn
useAdminAccess
thànhtrue
.
Để biết thêm thông tin và ví dụ, hãy xem bài viết Quản lý không gian trên Google Chat với tư cách là quản trị viên Google Workspace.
Chủ đề có liên quan
- Liệt kê các thành viên trong một không gian.
- Mời hoặc thêm người dùng hoặc ứng dụng Chat vào một không gian.
- Cập nhật tư cách thành viên của người dùng trong một không gian trên Google Chat.
- Xoá người dùng hoặc ứng dụng Chat khỏi không gian.