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 etkinlikleri nasıl kullanabileceğiniz açıklanmaktadır.

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

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

Google Workspace Events API'deki 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

Bir Google Workspace aboneliğinde hata oluştuğunda Google Workspace Events API, aboneliği askıya alır ve aboneliğin etkinlik almasını engeller. Aboneliği yeniden etkinleştirmeden önce abonelikle ilgili hataları gidermeniz gerekir.

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

Askıya alma etkinliği aldıktan sonra askıya alma nedenini öğrenebilir, hataları giderebilir ve aboneliği yeniden etkinleştirebilirsiniz. Ayrıntılar için Hataları giderme 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ü etkinliği 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ırlatıcı etkinlikleri

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

Google Workspace Events API, süresi dolan aboneliklerle ilgili olarak size bilgi vermek için yaşam döngüsü etkinliklerini süre dolmadan 12 saat ve 1 saat önce gönderir. Yaşam döngüsü etkinliklerinin etkinlik türü google.workspace.events.subscription.v1.expirationReminder'tür.

Süre sonu hatırlatıcısı etkinliği aldığınızda, süre sonu zamanını güncellemek için subscriptions.update() yöntemini kullanabilirsiniz. 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ü etkinliği 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 eren etkinlikler

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ü etkinliğinin etkinlik türü google.workspace.events.subscription.v1.expired'tür.

Google Workspace Events API, süresi dolmuş abonelikleri kalıcı olarak siler. Aboneliğinizin süresi dolduysa başka bir abonelik oluşturmak için subscriptions.create() yöntemini kullanabilirsiniz. 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ü etkinliği 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",
      ...
    }
  }
}