Google Workspace aboneliklerinin yaşam döngüsü olaylarını alın ve yanıtlayın

Bu sayfada, Google Workspace abonelikleri için aldığınız yaşam döngüsü olayları ve aboneliğinizi etkin durumda tutmak için bu etkinlikleri nasıl kullanabileceğiniz açıklanmaktadır.

Google Workspace Etkinlikleri API'si aşağıdaki yaşam döngüsü olayları türlerini gönderir:

Uygulamanız bu yaşam döngüsü etkinliği türlerini açıkça işlemeli ve gelecekte görünebilecek yeni etkinlik türlerini göz ardı etmelidir.

Google Workspace Etkinlikleri API'sinden gelen yaşam döngüsü etkinlikleri, CloudEvents spesifikasyonuna göre yapılandırılır. Daha fazla bilgi edinmek için Google Workspace etkinliklerinin yapısı bölümüne bakın.

Askıya alma etkinlikleri

Google Workspace aboneliğinde hata oluştuğunda Google Workspace Etkinlikleri API'si aboneliği askıya alır ve etkinlik almasını engeller. Yeniden etkinleştirmeden önce abonelikle ilgili hataları çözmeniz gerekir.

Google Workspace Etkinlikler API'si, askıya alınma durumunu size bildirmek için google.workspace.events.subscription.v1.suspended etkinlik türüyle bir yaşam döngüsü etkinliği gönderir.

Bir askıya alma olayı aldığınızda askıya alınma nedeni hakkında bilgi edinebilir, hataları giderebilir ve aboneliği yeniden etkinleştirebilirsiniz. Ayrıntılar için Hataları çözme ve Google Workspace aboneliğini yeniden etkinleştirme başlıklı makaleyi inceleyin.

Aşağıda, ENDPOINT_PERMISSION_DENIED hatası nedeniyle askıya alınan bir Google Workspace aboneliğiyle ilgili bir yaşam döngüsü etkinliğine ait CloudEvent gösterilmektedir:

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

Süre sonu hatırlatıcısı etkinlikleri

Süresi dolan abonelikler Google Workspace Etkinlikleri API'si tarafından kalıcı olarak silinir. Abonelikleri yenileyemez veya yeniden etkinleştiremezsiniz.

Google Workspace Etkinlikleri API'si, süresi dolan bir aboneliği size bildirmek için yaşam döngüsü olaylarını geçerlilik bitiş tarihinden 12 saat ve bir saat önce gönderir. Yaşam döngüsü olaylarının etkinlik türü google.workspace.events.subscription.v1.expirationReminder şeklindedir.

Geçerlilik sonu hatırlatıcısı etkinliği aldığınızda sona erme süresini güncellemek için subscriptions.update() yöntemini kullanabilirsiniz. Ayrıntılı bilgi için Google Workspace aboneliğini güncelleme veya yenileme başlıklı makaleyi inceleyin.

Aşağıda, süresi dolan bir Google Workspace aboneliğiyle ilgili yaşam döngüsü etkinliğine ait bir CloudEvent gösterilmektedir:

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

Aboneliğin süresi dolan etkinlikler

Google Workspace Etkinlikleri API'si, abonelik süresi dolduğunda size bir yaşam döngüsü etkinliği gönderir. Bu yaşam döngüsü etkinliğinin etkinlik türü: google.workspace.events.subscription.v1.expired.

Google Workspace Etkinlikleri API'si, süresi dolmuş abonelikleri kalıcı olarak siler. Aboneliğiniz sona ererse başka bir abonelik oluşturmak için subscriptions.create() yöntemini kullanabilirsiniz. Ayrıntılı bilgi için Google Workspace aboneliği oluşturma başlıklı makaleyi inceleyin.

Aşağıda, süresi dolmuş bir Google Workspace aboneliğiyle ilgili bir yaşam döngüsü etkinliğine ait CloudEvent gösterilmektedir:

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