یک جفت کلید رمزگذاری سمت سرویس گیرنده را خاموش می کند. کاربر احراز هویت شده دیگر نمی تواند از جفت کلید برای رمزگشایی متون پیام 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 از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها | |
|---|---|
userId | آدرس ایمیل اصلی درخواست کننده. برای نشان دادن کاربر احراز هویت شده، می توانید از مقدار ویژه |
keyPairId | شناسه جفت کلید برای خاموش کردن. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از CseKeyPair است.
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/gmail.settings.basic -
https://www.googleapis.com/auth/gmail.settings.sharing
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.