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 و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Method: users.settings.delegates.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nAdds a delegate with its verification status set directly to `accepted`, without sending any verification email. The delegate user must be a member of the same Google Workspace organization as the delegator user.\n\nGmail imposes limitations on the number of delegates and delegators each user in a Google Workspace organization can have. These limits depend on your organization, but in general each user can have up to 25 delegates and up to 10 delegators.\n\nNote that a delegate user must be referred to by their primary email address, and not an email alias.\n\nAlso note that when a new delegate is created, there may be up to a one minute delay before the new delegate is available for use.\n\nThis method is only available to service account clients that have been delegated domain-wide authority.\n\n### HTTP request\n\n`POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------------|\n| `userId` | `string` User's email address. The special value \"me\" can be used to indicate the authenticated user. |\n\n### Request body\n\nThe request body contains an instance of [Delegate](/workspace/gmail/api/reference/rest/v1/users.settings.delegates#Delegate).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Delegate](/workspace/gmail/api/reference/rest/v1/users.settings.delegates#Delegate).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/gmail.settings.sharing`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
