Cập nhật hoặc gia hạn gói thuê bao Google Workspace

Apps Script

• Gói thuê bao của Google Workspace. Để tạo một gói thuê bao, hãy xem bài viết Tạo gói thuê bao.

• Dự án Apps Script:
  • Sử dụng dự án trên đám mây của Google thay vì dự án mặc định do Apps Script tự động tạo.
  • Đối với tất cả phạm vi mà bạn đã thêm để định cấu hình màn hình xin phép bằ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ụ: nếu bạn chỉ định phạm vi chat.messages, hãy thêm nội dung sau:

  "oauthScopes": [
    "https://www.googleapis.com/auth/chat.messages"
  ]
      

  • Bật dịch vụ nâng cao Google Workspace Events.

• Yêu cầu xác thực và phạm vi uỷ quyền thích hợp cho từng loại sự kiện trong gói thuê bao:

  • Đối với quy trình xác thực người dùng, yêu cầu một hoặc nhiều phạm vi hỗ trợ ít nhất một trong các loại sự kiện cho gói thuê bao. Để xác định phạm vi, hãy xem bài viết Phạm vi theo loại sự kiện.
  • Để đăng ký sự kiện Chat dưới dạng ứng dụng Chat, bạn cần xác thực ứng dụng và quản trị viên phê duyệt một lần.

Python

• 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 cho Python. Để cài đặt hoặc cập nhật các thư viện 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 của Google Workspace. Để tạo một gói thuê bao, hãy xem bài viết Tạo gói thuê bao.

• Yêu cầu xác thực và phạm vi uỷ quyền thích hợp cho từng loại sự kiện trong gói thuê bao:

  • Đối với quy trình xác thực người dùng, yêu cầu một hoặc nhiều phạm vi hỗ trợ ít nhất một trong các loại sự kiện cho gói thuê bao. Để xác định phạm vi, hãy xem bài viết Phạm vi theo loại sự kiện.
  • Để đăng ký sự kiện Chat dưới dạng ứng dụng Chat, bạn cần xác thực ứng dụng và quản trị viên phê duyệt một lần.

Apps Script

1. Trong dự án Apps Script, hãy tạo một tệp tập lệnh mới có tên là updateSubscription rồi 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:

   • SUBSCRIPTION_ID: Mã của gói thuê bao. Để lấy mã, bạn có thể sử dụng bất kỳ cách nào sau đây:
     • Giá trị của trường uid.
     • Mã của tên tài nguyên được biểu thị trong trường name. Ví dụ: nếu tên tài nguyên là subscriptions/subscription-123, hãy sử dụng subscription-123.

2. Để cập nhật gói thuê bao của Google Workspace, hãy chạy hàm updateSubscription trong dự án Apps Script.

Python

1. Trong thư mục làm việc, hãy tạo một tệp có tên là 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('credentials.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ã, bạn có thể sử dụng bất kỳ cách nào sau đây:
     • Giá trị của trường uid.
     • Mã của tên tài nguyên được biểu thị trong trường name. Ví dụ: nếu tên tài nguyên là subscriptions/subscription-123, hãy sử dụng subscription-123.

2. Trong thư mục làm việc, hãy nhớ lưu trữ thông tin xác thực mã ứng dụng OAuth và đặt tên cho tệp là credentials.json. Mã mẫu sử dụng tệp JSON này để xác thực với Google Workspace và lấy thông tin xác thực người dùng. Để biết hướng dẫn, hãy xem Tạo thông tin xác thực mã ứng dụng khách OAuth .

3. Để cập nhật gói thuê bao của Google Workspace, hãy chạy lệnh sau trong thiết bị đầu cuối:

   python3 update_subscription.py

Python

  """Update subscription."""

  from google.oauth2 import service_account
  from apiclient.discovery import build

  # Specify required scopes.
  SCOPES = [SCOPES]

  # Specify service account details.
  CREDENTIALS = (
      service_account.Credentials.from_service_account_file('credentials.json')
      .with_scopes(SCOPES)
  )

  # Call the Workspace Events API using the service endpoint.
  service = build(
      'workspaceevents',
      'v1beta',
      credentials=CREDENTIALS,
  )

  BODY = {
      'ttl': {'seconds': 0},
  }
  NAME = 'subscriptions/SUBSCRIPTION_ID'
  response = (
      service.subscriptions()
      .patch(name=NAME, updateMask='ttl', body=BODY)
      .execute()
  )
  print(response)