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ü etkinlikleri ve etkin bir aboneliği sürdürmek için bu etkinliklerin nasıl kullanılacağı açıklanmaktadır.

Google Workspace Events API, aşağıdaki yaşam döngüsü etkinliklerini gönderir:

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

Google Workspace Events API'den alınan yaşam döngüsü etkinlikleri, CloudEvents spesifikasyonuna göre yapılandırılır. Daha fazla bilgi için Google Workspace etkinliklerinin yapısı başlıklı makaleyi inceleyin.

Askıya alma etkinlikleri

Google Workspace aboneliğinde bir hata oluştuğunda Google Workspace Events API, aboneliği askıya alır ve etkinlik almasını engeller. Yeniden etkinleştirmeden önce abonelikle ilgili tüm hataları düzeltin.

Google Workspace Events API, askıya alma işlemini bildirmek için etkinlik türü google.workspace.events.subscription.v1.suspended olan bir yaşam döngüsü olayı gönderir.

Askıya alma etkinliği aldıktan sonra askıya alma nedenini öğrenebilir, hataları düzeltebilir ve aboneliği yeniden etkinleştirebilirsiniz. Ayrıntılar için Hataları düzeltme 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 yaşam döngüsü olayı için 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.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ırlatma etkinlikleri

Aboneliğin süresi dolduktan sonra Google Workspace Events API, aboneliği kalıcı olarak siler. Bu aboneliği yenileyemez veya yeniden etkinleştiremezsiniz.

Google Workspace Events API, süresi dolan abonelikleri bildirmek için son kullanma tarihinden 12 saat ve 1 saat önce yaşam döngüsü etkinlikleri gönderir. Yaşam döngüsü etkinliklerinin etkinlik türü google.workspace.events.subscription.v1.expirationReminder'dır.

Son kullanma tarihi hatırlatma etkinliği aldığınızda son kullanma zamanını güncellemek için subscriptions.update() yöntemini kullanın. Ayrıntılar 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ü olayı için 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",
      ...
    }
  }
}

Abonelik süresi sona erdi etkinlikleri

Google Workspace Events API, aboneliğin süresi dolduğunda size bir yaşam döngüsü etkinliği gönderir. Bu yaşam döngüsü olayı için etkinlik türü google.workspace.events.subscription.v1.expired'dır.

Google Workspace Events API, süresi dolan abonelikleri kalıcı olarak siler. Aboneliğinizin süresi dolarsa başka bir abonelik oluşturmak için subscriptions.create() yöntemini kullanın. Ayrıntılar 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 yaşam döngüsü olayı için 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.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",
      ...
    }
  }
}