Auf dieser Seite werden die Lebenszyklusereignisse erläutert, die Sie für Google Workspace-Abos erhalten. Außerdem erfahren Sie, wie Sie diese Ereignisse verwenden können, um ein aktives Abo beizubehalten.
Die Google Workspace Events API sendet die folgenden Arten von Lebenszyklusereignissen:
- Sperrereignisse, durch die Sie benachrichtigt werden, wenn Ihr Abo aufgrund eines Fehlers gesperrt wurde.
- Erinnerungen zum Ablauf, die Sie darüber informieren, dass Ihr Abo bald abläuft.
- Abgelaufene Ereignisse, durch die Sie benachrichtigt werden, wenn Ihr Abo abläuft.
Ihre Anwendung sollte diese Lebenszyklusereignistypen explizit verarbeiten und neue Ereignistypen ignorieren, die in Zukunft auftreten könnten.
Lebenszyklusereignisse aus der Google Workspace Events API sind gemäß der CloudEvents-Spezifikation strukturiert. Weitere Informationen finden Sie unter Struktur von Google Workspace-Ereignissen.
Sperrereignisse
Wenn bei einem Google Workspace-Abo ein Fehler auftritt, sperrt die Google Workspace Events API das Abo und verhindert, dass es Ereignisse empfängt. Bevor Sie das Abo reaktivieren können, müssen Sie alle Fehler beheben.
Die Google Workspace Events API sendet ein Lebenszyklusereignis mit dem Ereignistyp google.workspace.events.subscription.v1.suspended, um Sie über eine Sperrung zu informieren.
Wenn Ihnen eine Sperrung gemeldet wird, können Sie den Grund für die Sperrung erfahren, Fehler beheben und das Abo reaktivieren. Weitere Informationen finden Sie unter Fehler beheben und Google Workspace-Abo reaktivieren.
Im Folgenden sehen Sie ein CloudEvent für ein Lebenszyklusereignis zu einem Google Workspace-Abo, das aufgrund des Fehlers ENDPOINT_PERMISSION_DENIED gesperrt wurde:
{
"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",
...
}
}
}
Erinnerungsereignisse für das Ablaufdatum
Nachdem ein Abo abgelaufen ist, wird es von der Google Workspace Events API endgültig gelöscht und kann nicht verlängert oder reaktiviert werden.
Die Google Workspace Events API sendet Lebenszyklusereignisse 12 Stunden und eine Stunde vor der Ablaufzeit, um Sie über ein ablaufendes Abo zu informieren. Der Ereignistyp für Lebenszyklus-Ereignisse ist google.workspace.events.subscription.v1.expirationReminder.
Wenn Sie eine Ablauferinnerung erhalten, können Sie die Ablaufzeit mit der Methode subscriptions.update() aktualisieren. Weitere Informationen finden Sie unter Google Workspace-Abo aktualisieren oder verlängern.
Im Folgenden sehen Sie ein CloudEvent für ein Lebenszyklus-Ereignis zu einem ablaufenden Google Workspace-Abo:
{
"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",
...
}
}
}
Abo-Abgelaufene Ereignisse
Die Google Workspace Events API sendet Ihnen ein Lebenszyklus-Ereignis, wenn das Abo abläuft. Der Ereignistyp für dieses Lebenszyklus-Ereignis ist google.workspace.events.subscription.v1.expired.
Die Google Workspace Events API löscht abgelaufene Abos dauerhaft.
Wenn Ihr Abo abläuft, können Sie mit der Methode subscriptions.create() ein weiteres Abo erstellen. Weitere Informationen findest du unter Google Workspace-Abo erstellen.
Im Folgenden sehen Sie ein CloudEvent für ein Lebenszyklusereignis zu einem abgelaufenen Google Workspace-Abo:
{
"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",
...
}
}
}