Method: users.settings.cse.identities.patch

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

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

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

درخواست HTTP

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

این URL از سینتکس Transcoding در 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 .