Method: users.settings.delegates.create
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Agrega un delegado con su estado de verificación establecido directamente en accepted, sin enviar ningún correo electrónico de verificación. El usuario delegado debe ser miembro de la misma organización de Google Workspace que el usuario delegante.
Gmail impone limitaciones en la cantidad de delegados y delegados que puede tener cada usuario en una organización de Google Workspace. Estos límites dependen de tu organización, pero, en general, cada usuario puede tener hasta 25 delegados y hasta 10 delegados.
Ten en cuenta que se debe hacer referencia a un usuario delegado por su dirección de correo electrónico principal, no por un alias de correo electrónico.
Además, ten en cuenta que, cuando se crea un delegado nuevo, puede haber un retraso de hasta un minuto antes de que esté disponible para su uso.
Este método solo está disponible para los clientes de cuentas de servicio a los que se les delegó la autoridad de todo el dominio.
Solicitud HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
userId |
string
Dirección de correo electrónico del usuario. Se puede usar el valor especial "me" para indicar el usuario autenticado.
|
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de Delegate.
Cuerpo de la respuesta
Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Delegate.
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/gmail.settings.sharing
Para obtener más información, consulta la Guía de autorización.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 2025-07-25 (UTC)"],[],[],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)."]]
