یک جفت کلید رمزگذاری سمت کلاینت را به طور دائم و فوری حذف میکند. شما فقط میتوانید جفت کلیدهایی را که بیش از 30 روز غیرفعال بودهاند، به طور دائم حذف کنید. برای غیرفعال کردن یک جفت کلید، از متد keypairs.disable استفاده کنید.
جیمیل نمیتواند هیچ پیامی را که توسط یک کلید حذفشده رمزگذاری شده است، بازیابی یا رمزگشایی کند. کاربران تأیید شده و مدیران Google Workspace دسترسی به خواندن پیامهای رمزگذاری شده را از دست میدهند.
برای مدیرانی که هویتها و جفتکلیدهای کاربران سازمان خود را مدیریت میکنند، درخواستها نیاز به مجوز با یک حساب کاربری سرویس دارند که اختیار واگذاری در سطح دامنه برای جعل هویت کاربران با دامنه https://www.googleapis.com/auth/gmail.settings.basic را دارد.
برای کاربرانی که هویت و جفت کلیدهای خود را مدیریت میکنند، درخواستها مستلزم فعال و پیکربندی شدن رمزگذاری کلید سختافزاری است.
درخواست HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:obliterate
این URL از سینتکس Transcoding در gRPC استفاده میکند.
پارامترهای مسیر
| پارامترها | |
|---|---|
userId | آدرس ایمیل اصلی درخواستکننده. برای مشخص کردن کاربر احراز هویتشده، میتوانید از مقدار ویژه |
keyPairId | شناسه جفت کلیدی که باید حذف شود. |
درخواست بدنه
بدنه درخواست باید خالی باشد.
بدنه پاسخ
در صورت موفقیت، بدنه پاسخ یک شیء JSON خالی خواهد بود.
دامنههای مجوز
به یکی از حوزههای OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/gmail.settings.basic -
https://www.googleapis.com/auth/gmail.settings.sharing
برای اطلاعات بیشتر، بهOAuth 2.0 Overview .