Method: users.settings.cse.identities.patch
تعمل هذه السياسة على ربط زوج مفاتيح مختلف بهوية تشفير حالية من جهة العميل. ويجب التحقّق من صحة مفتاحَي التشفير المعدَّلَين وفقًا للملفات الشخصية لشهادات S/MIME في Google.
طلب 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
لمزيد من المعلومات، راجِع دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-09-05 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-09-05 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This operation updates the key pair associated with an existing client-side encryption identity for a user in Gmail."],["The updated key pair must meet Google's S/MIME certificate profile requirements."],["You need to provide the user's email address and the email address of the client-side encryption identity to update."],["The request requires specific authorization scopes related to Gmail settings."],["A successful update returns the updated client-side encryption identity details."]]],["This describes how to update an existing client-side encryption identity with a new key pair via a `PATCH` request to `https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities/{emailAddress}`. The `userId` and `emailAddress` are specified as path parameters. The request body must contain a `CseIdentity` instance. A successful update returns a `CseIdentity` instance in the response. Authorization requires either the `gmail.settings.basic` or `gmail.settings.sharing` OAuth scope. The new key pair must align with Google's S/MIME certificate profiles.\n"]]
