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

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