Google Workspace की सदस्यताओं के लिए, लाइफ़साइकल इवेंट पाना और उनका जवाब देना

इस पेज पर, Google Workspace की सदस्यताओं के लिए मिलने वाले लाइफ़साइकल इवेंट के बारे में बताया गया है. साथ ही, यह भी बताया गया है कि सदस्यता चालू रखने के लिए, इवेंट का इस्तेमाल कैसे किया जा सकता है.

Google Workspace इवेंट एपीआई इस तरह के लाइफ़साइकल इवेंट भेजता है:

आपके ऐप्लिकेशन को लाइफ़साइकल इवेंट के इन टाइप को साफ़ तौर पर मैनेज करना चाहिए. साथ ही, आने वाले समय में दिखने वाले नए इवेंट टाइप को अनदेखा करना चाहिए.

Google Workspace Events API के लाइफ़साइकल इवेंट, CloudEvent स्पेसिफ़िकेशन के हिसाब से स्ट्रक्चर किए जाते हैं. ज़्यादा जानने के लिए, Google Workspace इवेंट का स्ट्रक्चर देखें.

निलंबन की घटनाएं

जब Google Workspace की किसी सदस्यता के साथ कोई गड़बड़ी होती है, तो Google Workspace इवेंट एपीआई उस सदस्यता को निलंबित कर देता है और इवेंट तक पहुंचने से रोकता है. सदस्यता को फिर से चालू करने से पहले, आपको उससे जुड़ी गड़बड़ी को ठीक करना होगा.

आपको निलंबन की सूचना देने के लिए, Google Workspace Events API एक लाइफ़साइकल इवेंट भेजता है, जिसमें इवेंट टाइप google.workspace.events.subscription.v1.suspended शामिल होता है.

निलंबन का इवेंट मिलने के बाद, आपको निलंबन की वजह पता चल सकती है. इसमें, गड़बड़ियों को ठीक करने और सदस्यता को फिर से चालू करने की सुविधा भी होती है. ज़्यादा जानकारी के लिए, गड़बड़ियां ठीक करें और Google Workspace की सदस्यता फिर से चालू करना देखें.

यहां Google Workspace की ऐसी सदस्यता के लाइफ़साइकल इवेंट के लिए CloudEvent के बारे में बताया गया है जो गड़बड़ी की वजह से निलंबित कर दी गई थी 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",
      ...
    }
  }
}

समयसीमा खत्म होने के रिमाइंडर से जुड़े इवेंट

सदस्यता की समयसीमा खत्म होने के बाद, Google Workspace इवेंट एपीआई इसे हमेशा के लिए मिटा देता है. हालांकि, इसे रिन्यू या फिर से चालू नहीं किया जा सकता.

सदस्यता की समयसीमा खत्म होने की सूचना देने के लिए, Google Workspace इवेंट एपीआई समयसीमा खत्म होने से 12 घंटे और एक घंटे पहले, लाइफ़साइकल इवेंट भेजता है. लाइफ़साइकल इवेंट के लिए, इवेंट टाइप google.workspace.events.subscription.v1.expirationReminder है.

जब आपको ऐक्सेस खत्म होने का रिमाइंडर वाला इवेंट मिलता है, तो समयसीमा खत्म होने का समय अपडेट करने के लिए, subscriptions.update() तरीके का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, Google Workspace की सदस्यता अपडेट या रिन्यू करना देखें.

यहां, Google Workspace की जिस सदस्यता की समयसीमा खत्म होने वाली है उसके लाइफ़साइकल इवेंट के लिए CloudEvent दिया गया है:

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

सदस्यता की समयसीमा खत्म होने वाले इवेंट

सदस्यता की समयसीमा खत्म होने पर, Google Workspace इवेंट एपीआई आपको एक लाइफ़साइकल इवेंट भेजता है. इस लाइफ़साइकल इवेंट के लिए इवेंट टाइप google.workspace.events.subscription.v1.expired है.

Google Workspace इवेंट एपीआई, उन सदस्यताओं को हमेशा के लिए मिटा देता है जिनकी समयसीमा खत्म हो गई है. अगर आपकी सदस्यता खत्म हो जाती है, तो दूसरी सदस्यता बनाने के लिए subscriptions.create() तरीके का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, Google Workspace की सदस्यता बनाना देखें.

यहां उस लाइफ़साइकल इवेंट के लिए CloudEvent के बारे में बताया गया है जिसकी Google Workspace सदस्यता की समयसीमा खत्म हो गई है:

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