Nhận và phản hồi các sự kiện trong vòng đời của gói thuê bao Google Workspace

Trang này giải thích các sự kiện trong vòng đời mà bạn nhận được cho gói thuê bao Google Workspace và cách sử dụng các sự kiện này để duy trì gói thuê bao đang hoạt động.

Google Workspace Events API gửi các loại sự kiện trong vòng đời sau đây:

Ứng dụng của bạn phải xử lý rõ ràng các loại sự kiện trong vòng đời này và bỏ qua các loại sự kiện mới có thể xuất hiện trong tương lai.

Các sự kiện trong vòng đời từ Google Workspace Events API được cấu trúc theo quy cách CloudEvents. Để tìm hiểu thêm, hãy xem Cấu trúc của các sự kiện trên Google Workspace.

Sự kiện tạm ngưng

Khi xảy ra lỗi đối với một gói thuê bao Google Workspace, Google Workspace Events API sẽ tạm ngưng gói thuê bao đó và ngăn gói thuê bao nhận các sự kiện. Giải quyết mọi lỗi liên quan đến gói thuê bao trước khi kích hoạt lại.

Để thông báo cho bạn về việc tạm ngưng, Google Workspace Events API sẽ gửi một sự kiện trong vòng đời có loại sự kiện là google.workspace.events.subscription.v1.suspended.

Sau khi nhận được thông báo về việc tạm ngưng, bạn có thể tìm hiểu lý do tạm ngưng, giải quyết mọi lỗi và kích hoạt lại gói thuê bao. Để biết thông tin chi tiết, hãy xem bài viết Giải quyết lỗi và kích hoạt lại gói thuê bao Google Workspace.

Sau đây là CloudEvent cho một sự kiện trong vòng đời về gói thuê bao của Google Workspace bị tạm ngưng do lỗi ENDPOINT_PERMISSION_DENIED:

{
  "id": "EVENT_UUID",
  "source": "//workspaceevents.googleapis.com/subscriptions/SUBSCRIPTION_ID",
  "subject": "//workspaceevents.googleapis.com/subscriptions/SUBSCRIPTION_ID",
  "type": "google.workspace.events.subscription.v1.suspended",
  "time": "2023-06-08T06:50:43.641299Z",
  "spec_version": '1.0',
  "datacontenttype": "application/json",
  "data": {
    "subscription":{
      "name": "subscriptions/SUBSCRIPTION_ID",
      "suspension_reason": "ENDPOINT_PERMISSION_DENIED",
      ...
    }
  }
}

Sự kiện nhắc nhở về thời gian hết hạn

Sau khi gói thuê bao hết hạn, Google Workspace Events API sẽ xoá gói đó vĩnh viễn và bạn không thể gia hạn hoặc kích hoạt lại gói đó.

Để thông báo cho bạn về một gói thuê bao sắp hết hạn, Google Workspace Events API sẽ gửi các sự kiện trong vòng đời 12 giờ và 1 giờ trước thời gian hết hạn. Loại sự kiện cho các sự kiện trong vòng đời là google.workspace.events.subscription.v1.expirationReminder.

Khi bạn nhận được sự kiện nhắc nhở hết hạn, hãy sử dụng phương thức subscriptions.update() để cập nhật thời gian hết hạn. Để biết thông tin chi tiết, hãy xem bài viết Cập nhật hoặc gia hạn gói thuê bao Google Workspace.

Sau đây là CloudEvent cho một sự kiện trong vòng đời về gói thuê bao của Google Workspace sắp hết hạn:

{
  "id": "EVENT_UUID",
  "source": "//workspaceevents.googleapis.com/subscriptions/SUBSCRIPTION_ID",
  "subject": "//workspaceevents.googleapis.com/subscriptions/SUBSCRIPTION_ID",
  "type": "google.workspace.events.subscription.v1.expirationReminder",
  "time": "2023-06-08T06:50:43.641299Z",
  "spec_version": '1.0',
  "datacontenttype": "application/json",
  "data": {
    "subscription":{
      "name": "subscriptions/SUBSCRIPTION_ID",
      "expire_time": "2023-06-08T18:50:43.641299Z",
      ...
    }
  }
}

Sự kiện gói thuê bao đã hết hạn

Google Workspace Events API sẽ gửi cho bạn một sự kiện trong vòng đời khi gói thuê bao hết hạn. Loại sự kiện cho sự kiện trong vòng đời này là google.workspace.events.subscription.v1.expired.

Google Workspace Events API sẽ xoá vĩnh viễn các gói thuê bao đã hết hạn. Nếu gói thuê bao của bạn hết hạn, hãy sử dụng phương thức subscriptions.create() để tạo một gói thuê bao khác. Để biết thông tin chi tiết, hãy xem bài viết Tạo gói thuê bao Google Workspace.

Sau đây là CloudEvent cho một sự kiện trong vòng đời về gói thuê bao của Google Workspace đã hết hạn:

{
  "id": "EVENT_UUID",
  "source": "//workspaceevents.googleapis.com/subscriptions/SUBSCRIPTION_ID",
  "subject": "//workspaceevents.googleapis.com/subscriptions/SUBSCRIPTION_ID",
  "type": "google.workspace.events.subscription.v1.expired",
  "time": "2023-06-08T07:00:00.000000Z",
  "spec_version": '1.0',
  "datacontenttype": "application/json",
  "data": {
    "subscription":{
      "name": "subscriptions/SUBSCRIPTION_ID",
      "expire_time": "2023-06-08T07:00:00.000000Z",
      ...
    }
  }
}