Otrzymywanie zdarzeń cyklu życia subskrypcji Google Workspace i odpowiadanie na nie

Na tej stronie znajdziesz informacje o zdarzeniach cyklu życia, które otrzymujesz w przypadku subskrypcji Google Workspace, oraz o tym, jak ich używać do utrzymywania aktywnej subskrypcji.

Interfejs Google Workspace Events API wysyła te typy zdarzeń cyklu życia:

Aplikacja powinna wyraźnie obsługiwać te typy zdarzeń związanych z cyklem życia i ignorować nowe typy zdarzeń, które mogą pojawić się w przyszłości.

Zdarzenia cyklu życia z interfejsu Google Workspace Events API są strukturyzowane zgodnie ze specyfikacją CloudEvents. Więcej informacji znajdziesz w artykule Struktura wydarzeń Google Workspace.

Zawieszenia

Gdy w przypadku abonamentu Google Workspace wystąpi błąd, interfejs Google Workspace Events API zawiesza subskrypcję i uniemożliwia jej otrzymywanie zdarzeń. Przed ponowną aktywacją subskrypcji usuń wszystkie błędy.

Aby powiadomić Cię o zawieszeniu, interfejs Google Workspace Events API wysyła zdarzenie cyklu życia o typie google.workspace.events.subscription.v1.suspended.

Po otrzymaniu powiadomienia o zawieszeniu możesz dowiedzieć się, dlaczego to nastąpiło, rozwiązać wszelkie błędy i ponownie aktywować subskrypcję. Więcej informacji znajdziesz w artykule Rozwiązywanie błędów i ponowne aktywowanie subskrypcji Google Workspace.

Poniżej znajduje się CloudEvent dotyczący zdarzenia cyklu życia abonamentu Google Workspace, który został zawieszony z powodu błędu 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",
      ...
    }
  }
}

Zdarzenia przypominające o wygaśnięciu

Po wygaśnięciu subskrypcji interfejs Google Workspace Events API trwale ją usuwa i nie można jej odnowić ani ponownie aktywować.

Aby powiadomić Cię o wygasającej subskrypcji, interfejs Google Workspace Events API wysyła zdarzenia cyklu życia na 12 godzin i na godzinę przed upływem terminu ważności. Typ zdarzenia dla zdarzeń związanych z cyklem życia to google.workspace.events.subscription.v1.expirationReminder.

Gdy otrzymasz zdarzenie przypominające o wygaśnięciu, użyj metody subscriptions.update(), aby zaktualizować czas wygaśnięcia. Szczegółowe informacje znajdziesz w artykule Aktualizowanie lub odnawianie subskrypcji Google Workspace.

Poniżej przedstawiamy CloudEvent dotyczący zdarzenia cyklu życia wygasającego abonamentu 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",
      ...
    }
  }
}

Zdarzenia wygaśnięcia subskrypcji

Interfejs Google Workspace Events API wysyła zdarzenie cyklu życia, gdy subskrypcja wygaśnie. Typem zdarzenia dla tego zdarzenia cyklu życia jest google.workspace.events.subscription.v1.expired.

Interfejs Google Workspace Events API trwale usuwa wygasłe subskrypcje. Jeśli subskrypcja wygaśnie, użyj metody subscriptions.create(), aby utworzyć kolejną. Więcej informacji znajdziesz w artykule Tworzenie subskrypcji Google Workspace.

Poniżej przedstawiono CloudEvent dotyczący zdarzenia cyklu życia wygasłego abonamentu 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",
      ...
    }
  }
}