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 از دستور GRPC Transcoding استفاده می کند.

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

پارامترها
userId

string

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

cseEmailAddress

string

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

درخواست بدن

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

بدن پاسخگو

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

محدوده مجوز

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

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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.