Crea un alias de usuario
El alias de un usuario es una dirección de correo electrónico alternativa que usa el mismo buzón que usa la dirección de correo electrónico principal. Un alias de usuario se puede asociar con un dominio de cuenta diferente al que dominio utilizado por la dirección de correo electrónico principal del usuario. En un plazo de 24 horas (a menudo, antes), el usuario comienza los correos electrónicos recibidos que se envían a esta dirección. La API requiere que el se confirmó la propiedad del dominio antes de crear el alias del usuario.
Para crear un alias de usuario, usa la siguiente solicitud POST
e incluye la autorización que se describe en Autorizar solicitudes. El userKey
puede ser la dirección de correo electrónico principal del usuario, el usuario id
o cualquiera de los alias del usuario correos electrónicos. Para conocer las propiedades de solicitud y respuesta, consulta la Referencia de API:
POST https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases
Solicitud JSON
La siguiente solicitud JSON muestra un ejemplo de solicitud para crear un alias del usuario. El usuario es liz@example.com y el alias es chica@example.com:
POST https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases
{ "alias": "chica@example.com" }
Si la respuesta es correcta, se mostrará un código de estado HTTP 201. Junto con el código de estado, la respuesta muestra las propiedades del alias del usuario nuevo.
Cómo recuperar todos los alias de usuario
Para recuperar todos los alias de usuario en todos los dominios, usa la siguiente solicitud GET
e incluye la autorización que se describe en Autorizar solicitudes. El userKey
puede ser la dirección de correo electrónico principal del usuario, el usuario id
o cualquiera de los alias del usuario correos electrónicos. Para conocer las propiedades de solicitud y respuesta, consulta la Referencia de API:
GET https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases
GET https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases
Todos los alias de usuario se muestran en orden alfabético. No hay un tamaño de página, como la cadena de consulta maxResults
o la paginación que se usa para "Recuperar todos los alias". respuesta.
Respuesta JSON
Si la respuesta es correcta, se mostrará un código de estado HTTP 200. Junto con el código de estado, la respuesta muestra los alias del usuario en orden alfabético. Estos dominios de alias son el dominio principal y otros dominios múltiples de la cuenta:
{ "kind": "directory#user#aliases", "aliases": [ { "kind": "directory#user#alias", "id": "the unique user id", "primary_email": "liz@example.com", "alias": "chica@example.com" }, { "kind": "directory#user#alias", "id": "the unique user id", "primary_email": "liz@example.com", "alias": "support@example.com" }, { "kind": "directory#user#alias", "id": "the unique user id", "primary_email": "liz@example.com", "alias": "help@hr.example.com" }, { "kind": "directory#user#alias", "id": "the unique user id", "primary_email": "liz@example.com", "alias": "tickets@jumboinc.com" } ] }
Borra el alias de un usuario
Para borrar un alias de usuario, usa la siguiente solicitud DELETE
y agrega el
autorización descrita en
Autoriza solicitudes. Puede tardar
hasta 24 horas para que se quite el alias. El
userKey
puede ser la dirección de correo electrónico principal del usuario, el usuario id
o cualquiera de
los alias de usuario correos electrónicos. Y aliasId
es el alias. dirección de correo electrónico que se envía
borrar. Para conocer las propiedades de solicitud y respuesta, consulta la
Referencia de la API.
DELETE https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases/aliasId
DELETE
borra el alias chica@example.com para userKey, liz@example.com:
DELETE https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases/chica@example.com
Si la respuesta es correcta, se mostrará un código de estado HTTP 200.