Method: users.settings.cse.identities.create

یک هویت رمزگذاری شده سمت کلاینت ایجاد و پیکربندی می‌کند که مجاز به ارسال ایمیل از حساب کاربری است. گوگل گواهی S/MIME را در یک دایرکتوری مشترک در سطح دامنه منتشر می‌کند تا افراد درون یک سازمان Google Workspace بتوانند هویت را رمزگذاری و به آن ایمیل ارسال کنند.

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

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

درخواست HTTP

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

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

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

پارامترها
userId

string

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

درخواست بدنه

بدنه درخواست شامل یک نمونه از CseIdentity است.

بدنه پاسخ

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

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

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

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

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