구독이 만료되면 Google Workspace Events API에서 구독을 영구적으로 삭제하며, 구독을 갱신하거나 재활성화할 수 없습니다.
만료되는 구독을 알려주기 위해 Google Workspace Events API는 만료 시간 12시간 전과 1시간 전에 수명 주기 이벤트를 전송합니다. 수명 주기 이벤트의 이벤트 유형은 google.workspace.events.subscription.v1.expirationReminder입니다.
Google Workspace Events API는 구독이 만료되면 수명 주기 이벤트를 전송합니다. 이 수명 주기 이벤트의 이벤트 유형은 google.workspace.events.subscription.v1.expired입니다.
Google Workspace Events API는 만료된 구독을 영구적으로 삭제합니다.
정기 결제가 만료되면 subscriptions.create() 메서드를 사용하여 다른 정기 결제를 만들 수 있습니다. 자세한 내용은 Google Workspace 구독 만들기를 참고하세요.
다음은 만료된 Google Workspace 구독에 관한 수명 주기 이벤트의 CloudEvent를 보여줍니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-05-08(UTC)"],[[["\u003cp\u003eThis page describes Google Workspace subscription lifecycle events, including suspension, expiration reminders, and expiration, which are used to maintain active subscriptions.\u003c/p\u003e\n"],["\u003cp\u003eThe Google Workspace Events API sends lifecycle events as structured CloudEvents to notify you about subscription suspensions, upcoming expirations, and actual expirations.\u003c/p\u003e\n"],["\u003cp\u003eUpon receiving suspension events, you can investigate the cause, resolve errors, and reactivate the subscription; expiration reminder events allow you to update the subscription's expiration time before it's deleted.\u003c/p\u003e\n"],["\u003cp\u003eWhen a Google Workspace subscription expires, you receive an expiration event and need to create a new subscription as the expired one is permanently deleted.\u003c/p\u003e\n"]]],["The Google Workspace Events API sends lifecycle events to manage subscriptions, including suspension, expiration reminders, and expiration notifications. Upon suspension, indicated by `google.workspace.events.subscription.v1.suspended`, errors must be resolved to reactivate. Expiration reminders, sent as `google.workspace.events.subscription.v1.expirationReminder`, allow for subscription renewal via `subscriptions.update()`. When subscriptions expire, indicated by `google.workspace.events.subscription.v1.expired`, they are permanently deleted, requiring a new subscription via `subscriptions.create()`. All events adhere to the CloudEvents specification.\n"],null,["# Receive and respond to lifecycle events for Google Workspace subscriptions\n\nThis page explains the lifecycle events that you receive for Google Workspace\nsubscriptions, and how you can use the events to maintain an active\nsubscription.\n\nThe Google Workspace Events API sends the following types of lifecycle events:\n\n- [Suspension events](#suspension) that notify you when your subscription is suspended due to an error.\n- [Expiration reminder events](#expiration-reminder) that notify you that your subscription is expiring soon.\n- [Expired events](#expired) that notify you when your subscription expires.\n\nYour app should explicitly handle these lifecycle event types and ignore\nnew event types that might appear in the future.\n\nLifecycle events from the Google Workspace Events API are structured according to\nthe CloudEvents specification. To learn more, see [Structure of\nGoogle Workspace events](/workspace/events/guides#structure-events).\n| **Note:** If your subscription encounters an error related to its notification endpoint, you might not receive lifecycle events. To learn about and address endpoint errors, you can monitor the endpoint itself. To monitor endpoints that are Google Cloud Pub/Sub topics, see [Handle\n| message failures](https://cloud.google.com/pubsub/docs/handling-failures).\n\nSuspension events\n-----------------\n\nWhen an error occurs for a Google Workspace subscription, the\nGoogle Workspace Events API suspends the subscription and prevents it from\nreceiving events. You must resolve any errors with the subscription before\nreactivating it.\n\nTo notify you of a suspension, the Google Workspace Events API sends a\nlifecycle event with the event type\n`google.workspace.events.subscription.v1.suspended`.\n\nAfter you receive a suspension event, you can learn about the reason for the\nsuspension, resolve any errors, and reactivate the subscription. For details,\nsee [Resolve errors and reactivate a Google Workspace\nsubscription](/workspace/events/guides/reactivate-subscription).\n\nThe following shows a CloudEvent for a lifecycle event about a\nGoogle Workspace subscription that was suspended due to the error\n`ENDPOINT_PERMISSION_DENIED`: \n\n```\n{\n \"id\": \"EVENT_UUID\",\n \"source\": \"//workspaceevents.googleapis.com/subscriptions/SUBSCRIPTION_ID\",\n \"subject\": \"//workspaceevents.googleapis.com/subscriptions/SUBSCRIPTION_ID\",\n \"type\": \"google.workspace.events.subscription.v1.suspended\",\n \"time\": \"2023-06-08T06:50:43.641299Z\",\n \"spec_version\": '1.0',\n \"datacontenttype\": \"application/json\",\n \"data\": {\n \"subscription\":{\n \"name\": \"subscriptions/SUBSCRIPTION_ID\",\n \"suspension_reason\": \"ENDPOINT_PERMISSION_DENIED\",\n ...\n }\n }\n}\n```\n\nExpiration reminder events\n--------------------------\n\nAfter a subscription expires, the\nGoogle Workspace Events API permanently deletes it, and you can't renew or\nreactivate it.\n\nTo notify you of an expiring subscription, the Google Workspace Events API\nsends lifecycle events 12 hours and one hour before the expiration time. The\nevent type for lifecycle events is\n`google.workspace.events.subscription.v1.expirationReminder`.\n\nWhen you receive an expiration reminder event, you can use the\n`subscriptions.update()` method to update the expire time. For details, see\n[Update or renew a Google Workspace\nsubscription](/workspace/events/guides/update-subscription).\n\nThe following shows a CloudEvent for a lifecycle event about an expiring\nGoogle Workspace subscription: \n\n```\n{\n \"id\": \"EVENT_UUID\",\n \"source\": \"//workspaceevents.googleapis.com/subscriptions/SUBSCRIPTION_ID\",\n \"subject\": \"//workspaceevents.googleapis.com/subscriptions/SUBSCRIPTION_ID\",\n \"type\": \"google.workspace.events.subscription.v1.expirationReminder\",\n \"time\": \"2023-06-08T06:50:43.641299Z\",\n \"spec_version\": '1.0',\n \"datacontenttype\": \"application/json\",\n \"data\": {\n \"subscription\":{\n \"name\": \"subscriptions/SUBSCRIPTION_ID\",\n \"expire_time\": \"2023-06-08T18:50:43.641299Z\",\n ...\n }\n }\n}\n```\n\nSubscription expired events\n---------------------------\n\nThe Google Workspace Events API sends you a lifecycle event when\nthe subcription expires. The event type for this lifecycle event is\n`google.workspace.events.subscription.v1.expired`.\n\nThe Google Workspace Events API permanently deletes expired subscriptions.\nIf your subscription expires, you can use the\n`subscriptions.create()` method to create another subscription. For details, see\n[Create a Google Workspace\nsubscription](/workspace/events/guides/create-subscription).\n\nThe following shows a CloudEvent for a lifecycle event about an expired\nGoogle Workspace subscription: \n\n```\n{\n \"id\": \"EVENT_UUID\",\n \"source\": \"//workspaceevents.googleapis.com/subscriptions/SUBSCRIPTION_ID\",\n \"subject\": \"//workspaceevents.googleapis.com/subscriptions/SUBSCRIPTION_ID\",\n \"type\": \"google.workspace.events.subscription.v1.expired\",\n \"time\": \"2023-06-08T07:00:00.000000Z\",\n \"spec_version\": '1.0',\n \"datacontenttype\": \"application/json\",\n \"data\": {\n \"subscription\":{\n \"name\": \"subscriptions/SUBSCRIPTION_ID\",\n \"expire_time\": \"2023-06-08T07:00:00.000000Z\",\n ...\n }\n }\n}\n```\n\nRelated topics\n--------------\n\n- [Structure of Google Workspace events](/workspace/events/guides#structure)\n- [Resolve errors and reactivate a subscription](/workspace/events/guides/reactivate-subscription)\n- [Update or renew a subscription](/workspace/events/guides/update-subscription)"]]
