Method: users.settings.cse.identities.create

إنشاء هوية "التشفير من جهة العميل" وضبطها، وهي هوية مفوَّضة لإرسال البريد من حساب المستخدم تنشر Google شهادة 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 بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
userId

string

عنوان البريد الإلكتروني الأساسي للمطلوب منه للإشارة إلى المستخدم الذي تمّت مصادقة هويته، يمكنك استخدام القيمة الخاصة me.

نص الطلب

يحتوي نص الطلب على مثال CseIdentity.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل تم إنشاؤه حديثًا من CseIdentity.

نطاقات التفويض

يتطلب أحد نطاقات OAuth التالية:

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

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.