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 API Google Chat để xem thông tin chi tiết về gói thành viên trong một 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ề bất kỳ gói thành viên nào trong tổ chức Google Workspace của mình.
Tài nguyên Membership
cho biết liệu người dùng hoặc ứng dụng Google Chat có được mời tham gia, có tham gia hay không tham gia không gian hay không.
Việc xác thực bằng tính năng xác thực ứng dụng cho phép ứng dụng Chat nhận được gói 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 loại trừ gói thành viên của ứng dụng Chat, bao gồm cả gói thành viên của chính ứng dụng đó. Thao tác xác thực bằng quy trình xác thực người dùng sẽ trả về các gói 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 dành cho doanh nghiệp hoặc doanh nghiệp lớn có quyền truy cập vào Google Chat.
- Thiết lập môi trường:
- Tạo 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.
- Cài đặt Thư viện ứng dụng đám mây Node.js.
- Tạo thông tin xác thực quyền truy cập dựa trên cách bạn muốn xác thực trong yêu cầu API Google Chat:
- Để xác thực là người dùng Chat, hãy tạo thông tin đăng nhập cho mã ứng dụng OAuth rồi lưu thông tin đăng nhập dưới dạng tệp JSON có tên
client_secrets.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 xác thực tài khoản dịch vụ và lưu thông tin xác thực dưới dạng tệp JSON có tên
credentials.json
.
- Để xác thực là người dùng Chat, hãy tạo thông tin đăng nhập cho mã ứng dụng OAuth rồi lưu thông tin đăng nhập 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 dưới dạng người dùng hay ứng dụng Chat.
- Phòng Google Chat trong đó người dùng đã xác thực hoặc gọi ứng dụng Chat là thành viên. Để xác thực là ứng dụng Chat, hãy thêm ứng dụng Chat vào không gian.
Python
- Tài khoản Google Workspace dành cho doanh nghiệp hoặc doanh nghiệp 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 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.
- Cài đặt Python Thư viện ứng dụng đám mây.
- Tạo thông tin xác thực quyền truy cập dựa trên cách bạn muốn xác thực trong yêu cầu API Google Chat:
- Để xác thực dưới dạng người dùng Chat, hãy tạo thông tin xác thực mã ứng dụng khách OAuth và lưu thông tin xác thực dưới dạng tệp JSON có tên
client_secrets.json
vào thư mục cục bộ. - Để xác thực với tư cách là ứng dụng Chat, hãy
tạo thông tin đăng nhập cho
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 dưới dạng người dùng Chat, hãy tạo thông tin xác thực mã ứng dụng khách 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 dưới dạng người dùng hay ứng dụng Chat.
- Một không gian 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 dành cho doanh nghiệp hoặc doanh nghiệp lớn có quyền truy cập vào Google Chat.
- Thiết lập môi trường:
- Tạo 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.
- Cài đặt Java Thư viện ứng dụng khách trên đám mây.
- Tạo thông tin xác thực quyền truy cập dựa trên cách bạn muốn xác thực trong yêu cầu API Google Chat:
- Để xác thực là người dùng Chat, hãy tạo thông tin đăng nhập cho mã ứng dụng OAuth rồi lưu thông tin đăng nhập dưới dạng tệp JSON có tên
client_secrets.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 xác thực tài khoản dịch vụ và lưu thông tin xác thực dưới dạng tệp JSON có tên
credentials.json
.
- Để xác thực là người dùng Chat, hãy tạo thông tin đăng nhập cho mã ứng dụng OAuth rồi lưu thông tin đăng nhập 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 dưới dạng người dùng hay ứng dụng Chat.
- Phòng Google Chat trong đó người dùng đã xác thực hoặc gọi ứng dụng Chat là thành viên. Để xác thực là ứ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 dành cho doanh nghiệp hoặc doanh nghiệp 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 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.
- Tạo một dự án Apps Script độc lập và bật Dịch vụ trò chuyện 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 là ứng dụng Chat, hãy tạo thông tin đăng nhập cho 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 dưới dạng người dùng hay ứng dụng Chat.
- Một không gian 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 là ứng dụng Chat, hãy thêm ứng dụng Chat vào không gian.
Xem chi tiết về gói thành viên
Để biết thông tin chi tiết về gói thành viên trong Google Chat, hãy truyền những thông tin sau vào yêu cầu của bạn:
- Với tính năng xác thực ứng dụng, hãy chỉ định phạm vi uỷ quyền
chat.bot
. Với tính năng xác thực người dùng, hãy chỉ định phạm vi uỷ quyềnchat.memberships.readonly
hoặcchat.memberships
. Phương pháp hay nhất là chọn phạm vi hạn chế nhất mà vẫn cho phép ứng dụng 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 gói thành viên từ tài nguyên gói thành viên của Google Chat.
Mua gói thành viên có 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ế 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 này bằng cách gọi phương thứcListMemberships()
.
API Chat trả về một thực thể của Membership
, trong đó nêu chi tiết gói thành viên đã chỉ định.
Mua gói thành viên bằng tính năng xác thực ứng 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 dụng:
Node.js
Python
Java
Apps Script
Để chạy mẫu này, hãy thay thế 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ể của Membership
nêu chi tiết về gói thành viên đã chỉ định.
Xem thông tin chi tiết về gói thành viên khi 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ề gói thành viên cho 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 quyền quản trị viên.
- Trong yêu cầu của bạn, 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 Google Chat với tư cách là quản trị viên Google Workspace.
Chủ đề có liên quan
- Liệt kê thành viên trong không gian.
- Mời hoặc thêm người dùng hoặc ứng dụng Chat vào không gian.
- Cập nhật trạng thái 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.