تلقّي أحداث مراحل النشاط والردّ عليها لاشتراكات Google Workspace

توضّح هذه الصفحة مراحل النشاط التي تتلقّاها لاشتراكات Google Workspace وكيفية استخدام هذه الأحداث للحفاظ على اشتراك نشط.

ترسِل واجهة برمجة التطبيقات Google Workspace Events API الأنواع التالية من أحداث مراحل النشاط:

ويجب أن يتعامل تطبيقك بشكل صريح مع أنواع أحداث مراحل النشاط هذه ويتجاهل أنواع الأحداث الجديدة التي قد تظهر في المستقبل.

يتم تنظيم أحداث مراحل النشاط من Google Workspace Events API وفقًا لمواصفات CloudEvent. لمزيد من المعلومات، راجِع بنية أحداث 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 ساعة وساعة واحدة من وقت انتهاء الصلاحية. نوع حدث مراحل النشاط هو 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",
      ...
    }
  }
}