Dịch vụ Sự kiện nâng cao trên Google Workspace cho phép bạn sử dụng API Sự kiện của Google Workspace trong Apps Script. API này cho phép bạn đăng ký tài nguyên trên Google Workspace để nhận các sự kiện liên quan mà mình quan tâm. Sự kiện biểu thị các thay đổi đối với tài nguyên, chẳng hạn như khi tài nguyên được tạo, cập nhật hoặc bị xoá.
Điều kiện tiên quyết
- Một dự án Apps Script dùng một dự án Google Cloud chuẩn thay vì dự án mặc định do Apps Script tạo tự động.
- Một chủ đề Pub/Sub được tạo trong cùng một dự án Google Cloud để nhận các sự kiện liên quan đến gói thuê bao. Để tạo chủ đề Pub/Sub, hãy xem phần Tạo và đăng ký chủ đề Pub/Sub.
- Để đăng ký nhận các sự kiện trên Chat, bạn phải thiết lập ứng dụng Google Chat trên trang cấu hình API Chat trong bảng điều khiển Google Cloud. Để tạo ứng dụng Google Chat, hãy xem phần Tạo ứng dụng Google Chat bằng Apps Script.
Các phạm vi uỷ quyền cần thiết đã được thêm vào tệp
appsscript.json
của dự án Apps Script. Phạm vi cần thiết phụ thuộc vào loại sự kiện và tài nguyên mục tiêu của gói thuê bao. Để biết thông tin chi tiết, hãy xem phần Chọn phạm vi API Sự kiện Google Workspace. Ví dụ:"oauthScopes": [ "https://www.googleapis.com/auth/chat.messages.readonly" ]
Tài liệu tham khảo
Để biết thêm thông tin về dịch vụ này, hãy xem Tài liệu tham khảo về API Sự kiện của Google Workspace. Giống như tất cả dịch vụ nâng cao trong Apps Script, dịch vụ Sự kiện của Google Workspace cũng sử dụng các đối tượng, phương thức và tham số giống như API công khai.
Mã mẫu
Các mẫu này cho bạn biết cách thực hiện các thao tác phổ biến trong API Sự kiện Google Workspace bằng dịch vụ nâng cao.
Tạo gói thuê bao
Để tạo gói thuê bao cho một tài nguyên trên Google Workspace, hãy thêm hàm sau vào mã của dự án Apps Script:
Liệt kê gói thuê bao
Để liệt kê các gói thuê bao được lọc theo loại sự kiện và tài nguyên mục tiêu, hãy thêm hàm sau vào mã của dự án Apps Script:
Mua gói thuê bao
Để lấy thông tin về một gói thuê bao, hãy thêm hàm sau vào mã của dự án Apps Script:
Cập nhật đăng ký
Để cập nhật hoặc gia hạn gói thuê bao, hãy thêm hàm sau vào mã của dự án Apps Script:
Kích hoạt lại gói thuê bao
Để kích hoạt lại gói thuê bao, hãy thêm hàm sau vào mã của dự án Apps Script:
Xoá gói thuê bao
Để xoá một gói thuê bao, hãy thêm hàm sau vào mã của dự án Apps Script:
Nhận thao tác
Hầu hết các phương thức API Sự kiện của Google Workspace đều trả về một hoạt động diễn ra trong thời gian dài.
Để xác định trạng thái của hoạt động, bạn có thể sử dụng phương thức operations.get()
.
Để lấy thông tin về một thao tác, hãy thêm hàm sau vào mã của dự án Apps Script:
Để lấy tên của một thao tác, hãy sử dụng giá trị từ trường name
được trả về từ một trong các phương thức API Sự kiện của Google Workspace, chẳng hạn như subscriptions.create()
hoặc subscriptions.patch()
.