Method: users.settings.delegates.create
نماینده‌ای را با وضعیت تأیید مستقیماً به accepted اضافه می‌کند، بدون ارسال ایمیل تأیید. کاربر نماینده باید عضو همان سازمان Google Workspace باشد که کاربر نماینده است.
Gmail محدودیت‌هایی را بر تعداد نمایندگان و نمایندگانی که هر کاربر در یک سازمان Google Workspace می‌تواند داشته باشد اعمال می‌کند. این محدودیت ها به سازمان شما بستگی دارد، اما به طور کلی هر کاربر می تواند تا 25 نماینده و حداکثر 10 نماینده داشته باشد.
توجه داشته باشید که یک کاربر نماینده باید با آدرس ایمیل اصلی خود ارجاع داده شود، نه با نام مستعار ایمیل.
همچنین توجه داشته باشید که وقتی یک نماینده جدید ایجاد می شود، ممکن است تا یک دقیقه تاخیر قبل از اینکه نماینده جدید برای استفاده در دسترس باشد، وجود داشته باشد.
این روش فقط برای سرویس گیرندگان حساب خدماتی در دسترس است که اختیارات گسترده دامنه به آنها واگذار شده است.
درخواست HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| مولفه های |
|---|
userId | string آدرس ایمیل کاربر. مقدار ویژه "me" را می توان برای نشان دادن کاربر تأیید شده استفاده کرد. |
درخواست بدن
بدنه درخواست حاوی نمونه ای از Delegate است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه جدیدی از Delegate است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/gmail.settings.sharing
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-09-05 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-09-05 بهوقت ساعت هماهنگ جهانی."],[[["Adds a delegate to a user's Gmail account with verification status set to `accepted` without requiring email verification, given the delegate is in the same Google Workspace organization."],["Gmail has limits on the number of delegates and delegators a user can have, typically around 25 delegates and 10 delegators per user."],["Delegate users must be referred to by their primary email address, the new delegate may take up to a minute to be available, and this method requires domain-wide authority delegated to service account clients."],["This functionality is accessed via a POST request to the specified URL with path parameters including the user's email address, a request body containing a `Delegate` instance, and a response body, upon success, also containing a `Delegate` instance."],["Authorization for this method requires the `https://www.googleapis.com/auth/gmail.settings.sharing` OAuth scope."]]],[]]
