Method: users.settings.cse.identities.delete

هویت رمزگذاری شده سمت کلاینت را حذف می‌کند. کاربر احراز هویت شده دیگر نمی‌تواند از هویت برای ارسال پیام‌های رمزگذاری شده استفاده کند.

شما نمی‌توانید هویت را پس از حذف، بازیابی کنید. در عوض، از متد identities.create برای ایجاد یک هویت دیگر با همان پیکربندی استفاده کنید.

برای مدیرانی که هویت‌ها و جفت‌کلیدهای کاربران سازمان خود را مدیریت می‌کنند، درخواست‌ها نیاز به مجوز با یک حساب کاربری سرویس دارند که اختیار واگذاری در سطح دامنه برای جعل هویت کاربران با دامنه https://www.googleapis.com/auth/gmail.settings.basic را دارد.

برای کاربرانی که هویت و جفت کلیدهای خود را مدیریت می‌کنند، درخواست‌ها مستلزم فعال و پیکربندی شدن رمزگذاری کلید سخت‌افزاری است.

درخواست HTTP

DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
userId

string

آدرس ایمیل اصلی درخواست‌کننده. برای مشخص کردن کاربر احراز هویت‌شده، می‌توانید از مقدار ویژه me استفاده کنید.

cseEmailAddress

string

آدرس ایمیل اصلی مرتبط با پیکربندی هویت رمزگذاری سمت کلاینت که حذف شده است.

درخواست بدنه

بدنه درخواست باید خالی باشد.

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ یک شیء JSON خالی خواهد بود.

دامنه‌های مجوز

به یکی از حوزه‌های OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .