รับและตอบกลับเหตุการณ์ในวงจรสำหรับการสมัครใช้บริการ Google Workspace

หน้านี้อธิบายเหตุการณ์วงจรการใช้งานที่คุณได้รับสำหรับการสมัครใช้บริการ Google Workspace และวิธีใช้เหตุการณ์เพื่อคงสถานะการสมัครใช้บริการให้ใช้งานได้

Google Workspace Events API จะส่งเหตุการณ์วงจรประเภทต่อไปนี้

แอปของคุณควรจัดการประเภทเหตุการณ์วงจรนี้อย่างชัดเจนและไม่สนใจ ประเภทเหตุการณ์ใหม่ๆ ที่อาจปรากฏในอนาคต

เหตุการณ์วงจรจาก Google Workspace Events API มีโครงสร้าง ตามข้อกำหนดของ CloudEvents ดูข้อมูลเพิ่มเติมได้ที่โครงสร้างของ กิจกรรมใน Google Workspace

งานกิจกรรมการแขวน

เมื่อเกิดข้อผิดพลาดสำหรับการสมัครใช้บริการ Google Workspace ทาง Google Workspace Events API จะระงับการสมัครใช้บริการและป้องกันไม่ให้รับเหตุการณ์ แก้ไขข้อผิดพลาดเกี่ยวกับการสมัครใช้บริการก่อน เปิดใช้งานอีกครั้ง

Google Workspace Events API จะส่งเหตุการณ์วงจรที่มีประเภทเหตุการณ์ google.workspace.events.subscription.v1.suspended เพื่อแจ้งให้คุณทราบเกี่ยวกับการระงับ

หลังจากได้รับเหตุการณ์การระงับ คุณจะดูสาเหตุของการระงับ แก้ไขข้อผิดพลาด และเปิดใช้งานการสมัครใช้บริการอีกครั้งได้ โปรดดูรายละเอียดที่หัวข้อแก้ไขข้อผิดพลาดและเปิดใช้งานการสมัครใช้บริการ Google Workspace อีกครั้ง

ต่อไปนี้คือ CloudEvent สำหรับเหตุการณ์วงจรของ การสมัครใช้บริการ Google Workspace ที่ถูกระงับเนื่องจากข้อผิดพลาด 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",
      ...
    }
  }
}

เหตุการณ์การช่วยเตือนเรื่องการหมดอายุ

หลังจากที่การสมัครใช้บริการหมดอายุแล้ว Google Workspace Events API จะลบการสมัครใช้บริการนั้นอย่างถาวร และคุณจะต่ออายุหรือ เปิดใช้งานอีกครั้งไม่ได้

Google Workspace Events API จะส่งเหตุการณ์วงจรของแอป 12 ชั่วโมงและ 1 ชั่วโมงก่อนเวลาหมดอายุเพื่อแจ้งให้คุณทราบว่าการสมัครใช้บริการกำลังจะหมดอายุ ประเภทเหตุการณ์สำหรับเหตุการณ์วงจรคือ google.workspace.events.subscription.v1.expirationReminder

เมื่อได้รับเหตุการณ์การช่วยเตือนการหมดอายุ ให้ใช้วิธีการ subscriptions.update() เพื่ออัปเดตเวลาหมดอายุ โปรดดูรายละเอียดที่หัวข้ออัปเดตหรือต่ออายุการสมัครใช้บริการ Google Workspace

ต่อไปนี้คือ CloudEvent สำหรับเหตุการณ์วงจรเกี่ยวกับ การสมัครใช้บริการ Google Workspace ที่กำลังจะหมดอายุ

{
  "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",
      ...
    }
  }
}

เหตุการณ์การสมัครใช้บริการหมดอายุ

Google Workspace Events API จะส่งเหตุการณ์วงจรให้คุณเมื่อการสมัครใช้บริการหมดอายุ ประเภทเหตุการณ์สำหรับเหตุการณ์วงจรนี้คือ google.workspace.events.subscription.v1.expired

Google Workspace Events API จะลบการสมัครใช้บริการที่หมดอายุแล้วอย่างถาวร หากการสมัครใช้บริการหมดอายุ ให้ใช้วิธีการ subscriptions.create()เพื่อสร้างการสมัครใช้บริการอีกรายการ โปรดดูรายละเอียดที่หัวข้อ สร้างการสมัครใช้บริการ Google Workspace

ต่อไปนี้คือ CloudEvent สำหรับเหตุการณ์วงจรเกี่ยวกับ การสมัครใช้บริการ Google Workspace ที่หมดอายุ

{
  "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",
      ...
    }
  }
}