建立使用者別名
使用者的別名是備用電子郵件地址，所使用的地址與使用者的主要電子郵件地址相同。使用者別名可與不同的主要電子郵件地址所用的帳戶網域不同。在 24 小時內 (通常會更快)，使用者就會開始收到傳送至這個地址的電子郵件。API 規定網域擁有權必須通過驗證，才能建立使用者別名。
如要建立使用者別名，請使用下列 POST 要求並納入授權要求中說明的授權。userKey 可以是使用者的主要電子郵件地址、使用者 id，或是任何使用者別名的電子郵件地址。如需要求與回應屬性，請參閱 API 參考資料：
POST https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases
JSON 要求
以下 JSON 要求顯示建立使用者別名的範例要求。使用者為 liz@example.com，別名為 chica@example.com：
POST https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases要求主體包含新的別名資訊：
{
"alias": "chica@example.com"
}
成功的回應會傳回 HTTP 201 狀態碼。狀態碼會回應使用者新別名的屬性。
擷取使用者的所有別名
如要擷取所有網域的使用者別名，請使用下列 GET 要求，並附上授權要求中所述的授權。userKey 可以是使用者的主要電子郵件地址、使用者 id，或是任何使用者別名的電子郵件地址。如需要求與回應屬性，請參閱 API 參考資料：
GET https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases
舉例來說，此要求 URI 會傳回 userKey liz@example.com 的所有別名：
GET https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases
系統會按照字母順序傳回所有使用者別名。沒有任何網頁大小 (例如 maxResults 查詢字串或用於「擷取所有別名」回應的分頁)。
JSON 回應
成功的回應會傳回 HTTP 200 狀態碼。除了狀態碼以外，回應也會依字母順序傳回使用者的別名。這些別名網域是主網域和帳戶中的其他多個網域：
{
"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"
}
]
}
刪除使用者的別名
如要刪除使用者別名，請使用下列 DELETE 要求，並加入授權要求中所述的授權。系統最多可能需要 24 小時才會移除別名。userKey 可以是使用者的主要電子郵件地址、使用者 id，或是任何使用者別名的電子郵件地址。而 aliasId 是要刪除的別名電子郵件地址。如需要求與回應屬性，請參閱 API 參考資料。
DELETE https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases/aliasId舉例來說，這個
DELETE 要求會刪除 userKey liz@example.com 的 chica@example.com 別名：
DELETE https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases/chica@example.com
成功的回應會傳回 HTTP 200 狀態碼。