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