Ricevi e rispondi a eventi del ciclo di vita per gli abbonamenti a Google Workspace

Questa pagina illustra gli eventi del ciclo di vita che ricevi per gli abbonamenti a Google Workspace e come puoi utilizzarli per mantenere un abbonamento attivo.

L'API Google Workspace Eventi invia i seguenti tipi di eventi del ciclo di vita:

La tua app dovrebbe gestire in modo esplicito questi tipi di eventi del ciclo di vita e ignorare i nuovi tipi di eventi che potrebbero apparire in futuro.

Gli eventi del ciclo di vita dell'API Eventi di Google Workspace sono strutturati in base alla specifica CloudEvents. Per saperne di più, consulta Struttura degli eventi di Google Workspace.

Eventi di sospensione

Quando si verifica un errore per un abbonamento a Google Workspace, l'API Google Workspace Eventi sospende l'abbonamento e gli impedisce di ricevere eventi. Devi risolvere eventuali errori relativi all'abbonamento prima di riattivarlo.

Per informarti di una sospensione, l'API Google Workspace Eventi invia un evento del ciclo di vita con il tipo di evento google.workspace.events.subscription.v1.suspended.

Dopo aver ricevuto un evento di sospensione, puoi scoprire il motivo della sospensione, risolvere eventuali errori e riattivare l'abbonamento. Per maggiori dettagli, vedi Risolvere gli errori e riattivare un abbonamento a Google Workspace.

Di seguito è mostrato un evento CloudEvent per un evento del ciclo di vita relativo a un abbonamento a Google Workspace che è stato sospeso a causa dell'errore 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",
      ...
    }
  }
}

Eventi di promemoria relativi alla scadenza

Dopo la scadenza di un abbonamento, l'API Google Workspace Eventi lo elimina definitivamente e non puoi rinnovarlo o riattivarlo.

Per notificarti un abbonamento in scadenza, l'API Google Workspace Eventi invia eventi del ciclo di vita 12 ore e un'ora prima della scadenza. Il tipo di evento per gli eventi del ciclo di vita è google.workspace.events.subscription.v1.expirationReminder.

Quando ricevi un evento di promemoria di scadenza, puoi utilizzare il metodo subscriptions.update() per aggiornare la data e l'ora della scadenza. Per maggiori dettagli, consulta Aggiornare o rinnovare un abbonamento a Google Workspace.

Di seguito è mostrato un evento CloudEvent per un evento del ciclo di vita relativo a un abbonamento a Google Workspace in scadenza:

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

Eventi di iscrizione scaduta

L'API Google Workspace Eventi ti invia un evento del ciclo di vita alla scadenza dell'abbonamento. Il tipo di evento per questo evento del ciclo di vita è google.workspace.events.subscription.v1.expired.

L'API Google Workspace Eventi elimina definitivamente gli abbonamenti scaduti. Se il tuo abbonamento scade, puoi utilizzare il metodo subscriptions.create() per creare un altro abbonamento. Per maggiori dettagli, consulta Creare un abbonamento a Google Workspace.

Di seguito è mostrato un evento CloudEvent per un evento del ciclo di vita relativo a un abbonamento a Google Workspace scaduto:

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