API Directory: aliases de usuário

Criar um alias de usuário

O alias de um usuário é um endereço de e-mail alternativo que usa a mesma caixa de e-mails usada pelo endereço de e-mail principal. Um alias de usuário pode ser associado a um domínio de conta diferente daquele domínio utilizado pelo endereço de e-mail principal do usuário. Em 24 horas (geralmente antes), o usuário começa recebendo e-mails enviados para este endereço. A API exige que o a propriedade do domínio é confirmada antes de criar o alias de usuário.

Para criar um alias de usuário, use a seguinte solicitação POST e inclua a autorização descrita em Autorizar solicitações. O userKey pode ser o endereço de e-mail principal do usuário, o id do usuário ou qualquer um dos aliases e-mails. Para obter as propriedades de solicitação e resposta, consulte a Referência da API: 

POST https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases

Solicitação JSON

A solicitação JSON a seguir mostra um exemplo de solicitação para criar o alias de um usuário. O usuário é liz@example.com e o alias é chica@example.com: 

POST https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases
O corpo da solicitação tem as novas informações de alias: 
{  
 "alias": "chica@example.com"
}

Uma resposta bem-sucedida retorna um código de status HTTP 201. Juntamente com o código de status, a resposta retorna as propriedades do novo alias de usuário.

Recuperar todos os aliases de um usuário

Para recuperar todos os aliases de um usuário em todos os domínios, use a seguinte solicitação GET e inclua a autorização descrita em Autorizar solicitações. O userKey pode ser o endereço de e-mail principal do usuário, o id do usuário ou qualquer um dos aliases e-mails. Para obter as propriedades de solicitação e resposta, consulte a Referência da API: 

GET https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases
Por exemplo, este URI de solicitação retorna todos os aliases de userKey, liz@example.com: 
GET https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases

Todos os aliases de usuário são retornados em ordem alfabética. Não há tamanho de página, como a string de consulta maxResults ou a paginação que foi usado na opção "Recuperar todos os aliases" resposta.

Resposta JSON

Uma resposta bem-sucedida retorna um código de status HTTP 200. Junto com o código de status, a resposta retorna os aliases do usuário em ordem alfabética. Esses domínios de alias são o domínio principal e outros múltiplos domínios na conta: 

{
"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"
 }
]
}

Excluir o alias de um usuário

Para excluir um alias de usuário, use a seguinte solicitação DELETE e inclua o autorização descrita em Autorizar solicitações Pode demorar até até 24 horas para que o alias seja removido. A userKey pode ser o endereço de e-mail principal do usuário, o usuário id ou qualquer um dos o alias de usuário e-mails. E o aliasId é o alias endereço de e-mail que está sendo excluída. Para obter as propriedades de solicitação e resposta, consulte a Referência da API. 

DELETE https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases/aliasId
Por exemplo, a solicitação DELETE a seguir exclui o 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

Uma resposta bem-sucedida retorna um código de status HTTP 200.