Method: users.settings.cse.keypairs.obliterate

यह क्लाइंट-साइड एन्क्रिप्शन की कुंजियों के जोड़े को हमेशा के लिए और तुरंत मिटा देता है. सिर्फ़ उन कुंजी जोड़े को हमेशा के लिए मिटाया जा सकता है जिन्हें बंद किए हुए 30 दिन से ज़्यादा हो गए हैं. किसी की-वैल्यू पेयर को बंद करने के लिए, keypairs.disable तरीके का इस्तेमाल करें.

Gmail, मिटाई गई कुंजी से एन्क्रिप्ट (सुरक्षित) किए गए किसी भी मैसेज को न तो वापस ला सकता है और न ही उसे डिक्रिप्ट (सुरक्षित तरीके से बदलना) कर सकता है. पुष्टि किए गए उपयोगकर्ताओं और Google Workspace एडमिन के पास, एन्क्रिप्ट (सुरक्षित) किए गए मैसेज पढ़ने का ऐक्सेस नहीं रहता.

अपने संगठन के उपयोगकर्ताओं के लिए पहचान और कुंजी जोड़े मैनेज करने वाले एडमिन को अनुरोधों के लिए अनुमति चाहिए. इसके लिए, उन्हें सेवा खाते का इस्तेमाल करना होगा. इस खाते के पास पूरे डोमेन के लिए डेलिगेशन की अनुमति होनी चाहिए, ताकि वह https://www.googleapis.com/auth/gmail.settings.basic स्कोप वाले उपयोगकर्ताओं के तौर पर काम कर सके.

अपनी पहचान और की-पेयर मैनेज करने वाले उपयोगकर्ताओं के लिए, अनुरोधों में हार्डवेयर की एन्क्रिप्शन चालू और कॉन्फ़िगर होना चाहिए.

एचटीटीपी अनुरोध

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:obliterate

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
userId

string

अनुरोध करने वाले व्यक्ति का मुख्य ईमेल पता. प्रमाणीकरण किए गए उपयोगकर्ता के लिए, me वैल्यू का इस्तेमाल किया जा सकता है.

keyPairId

string

मिटाने के लिए कुंजी के जोड़े का आइडेंटिफ़ायर.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

अगर अनुरोध पूरा हो जाता है, तो जवाब के मुख्य हिस्से में एक खाली JSON ऑब्जेक्ट होता है.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/gmail.settings.basic
  • https://www.googleapis.com/auth/gmail.settings.sharing

ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.