Trang này giải thích cách gia hạn gói thuê bao Google Workspace bằng phương thức subscriptions.update()
. Bạn có thể sử dụng phương thức này để cập nhật thời gian hết hạn của gói thuê bao, bao gồm cả việc gia hạn gói thuê bao trong thời gian hết hạn tối đa có thể hoặc cập nhật danh sách các loại sự kiện cần nhận về tài nguyên mục tiêu.
Apps Script
- Gói thuê bao Google Workspace. Để tạo một gói thuê bao, hãy xem phần Tạo gói thuê bao.
Yêu cầu xác thực người dùng bằng một hoặc nhiều phạm vi hỗ trợ tất cả các loại sự kiện cho gói thuê bao.
- Một dự án Apps Script:
- Sử dụng dự án Google Cloud thay vì dự án mặc định do Apps Script tạo tự động.
- Đối với mọi phạm vi mà bạn đã thêm để định cấu hình màn hình đồng ý OAuth, bạn cũng phải thêm các phạm vi đó vào tệp
appsscript.json
trong dự án Apps Script. Ví dụ: - Bật
dịch vụ nâng cao
Google Workspace Events
.
"oauthScopes": [ "https://www.googleapis.com/auth/chat.messages.readonly" ]
Python
- Python 3.6 trở lên
- Công cụ quản lý gói pip
- Thư viện ứng dụng Google mới nhất cho Python. Để cài đặt hoặc cập nhật các gói 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
- Gói thuê bao Google Workspace. Để tạo một gói thuê bao, hãy xem phần Tạo gói thuê bao.
Yêu cầu xác thực người dùng bằng một hoặc nhiều phạm vi hỗ trợ tất cả các loại sự kiện cho gói thuê bao.
Gia hạn gói thuê bao Google Workspace
Trong phần này, bạn sử dụng phương thức subscriptions.update()
của API Sự kiện Google Workspace để gia hạn gói thuê bao đến thời gian hết hạn tối đa. Để chỉ định thời gian hết hạn tối đa, bạn cập nhật trường ttl
của tài nguyên Subscription
thành 0
.
Thời gian hết hạn tối đa phụ thuộc vào dữ liệu tài nguyên có trong tải trọng sự kiện. Để tìm hiểu thêm về thời gian hết hạn, hãy xem bài viết Dữ liệu sự kiện cho sự kiện trên Google Workspace.
Cách gia hạn gói thuê bao Google Workspace:
Apps Script
Trong dự án Apps Script, hãy tạo một tệp tập lệnh mới tên là
updateSubscription
và thêm mã sau:function updateSubscription() { // The name of the subscription to update. const name = 'subscriptions/SUBSCRIPTION_ID'; // Call the Workspace Events API using the advanced service. const response = WorkspaceEvents.Subscriptions.patch({ ttl: '0s', }, name); console.log(response); }
Thay thế nội dung sau:
Để cập nhật gói thuê bao Google Workspace, hãy chạy hàm
updateSubscription
trong dự án Apps Script.
Python
Trong thư mục đang hoạt động, hãy tạo một tệp có tên
update_subscription.py
rồi thêm mã sau:"""Update subscription.""" from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build # Specify required scopes. SCOPES = [SCOPES] # Authenticate with Google Workspace and get user authentication. flow = InstalledAppFlow.from_client_secrets_file('client_secrets.json', SCOPES) CREDENTIALS = flow.run_local_server() # Call the Workspace Events API using the service endpoint. service = build( 'workspaceevents', 'v1', credentials=CREDENTIALS, ) BODY = { 'ttl': {'seconds': 0}, } NAME = 'subscriptions/SUBSCRIPTION_ID' response = ( service.subscriptions() .patch(name=NAME, updateMask='ttl', body=BODY) .execute() ) print(response)
Thay thế nội dung sau:
SCOPES
: Một hoặc nhiều phạm vi OAuth hỗ trợ từng loại sự kiện cho gói thuê bao. Được định dạng dưới dạng một mảng chuỗi. Để liệt kê nhiều phạm vi, hãy phân tách bằng dấu phẩy. Ví dụ:'https://www.googleapis.com/auth/chat.spaces.readonly', 'https://www.googleapis.com/auth/chat.memberships.readonly'
.SUBSCRIPTION_ID
: Mã của gói thuê bao. Để lấy mã nhận dạng, bạn có thể sử dụng bất kỳ phương thức nào sau đây:
Trong thư mục đang hoạt động, hãy đảm bảo bạn đã lưu trữ thông tin xác thực mã ứng dụng khách OAuth và đặt tên tệp là
client_secrets.json
. Mẫu mã sử dụng tệp JSON này để xác thực bằng Google Workspace và lấy thông tin xác thực của người dùng. Để biết hướng dẫn, hãy xem phần Tạo thông tin xác thực mã ứng dụng khách OAuth.Để cập nhật gói thuê bao Google Workspace, hãy chạy lệnh sau trong dòng lệnh:
python3 update_subscription.py
Subscription
.
Để biết thông tin chi tiết về tài nguyên Subscription
đã cập nhật, hãy sử dụng phương thức operations.get()
và chỉ định tài nguyên Operation
được trả về từ yêu cầu subscriptions.update()
. Nếu không, nếu bạn chỉ định tài nguyên Operation
từ phiên bản trước của gói thuê bao, thì phản hồi sẽ trống.