รับและตอบกลับเหตุการณ์ในวงจรสำหรับการสมัครใช้บริการ 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",
      ...
    }
  }
}