Method: users.settings.cse.identities.patch

يربط هذا الإجراء زوج مفاتيح مختلفًا بهوية حالية للتشفير من جهة العميل. يجب أن يتم التحقّق من صحة زوج المفاتيح المعدَّل باستخدام الملفات الشخصية لشهادات S/MIME من Google.

بالنسبة إلى المشرفين الذين يديرون هويات ومفاتيح للمستخدمين في مؤسستهم، تتطلّب الطلبات الحصول على إذن باستخدام حساب خدمة لديه إذن تفويض على مستوى النطاق لانتحال هوية المستخدمين باستخدام النطاق https://www.googleapis.com/auth/gmail.settings.basic.

بالنسبة إلى المستخدمين الذين يديرون هوياتهم وأزواج المفاتيح، تتطلّب الطلبات تفعيل تشفير مفتاح الجهاز وإعداده.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

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

المعلمات
userId

string

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

string

عنوان البريد الإلكتروني الخاص بهوية التشفير من جهة العميل المطلوب تعديله.

نص الطلب

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

نص الاستجابة

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

نطاقات الأذونات

يجب توفير أحد نطاقات OAuth التالية:

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.