Directory API: Bí danh người dùng

Tạo email đại diện cho người dùng

Email đại diện của người dùng là một địa chỉ email thay thế sử dụng cùng một hộp thư với địa chỉ email chính của người dùng. Email đại diện của người dùng có thể được liên kết với một miền tài khoản khác với miền mà địa chỉ email chính của người dùng sử dụng. Trong vòng 24 giờ (thường là sớm hơn), người dùng sẽ bắt đầu nhận email gửi đến địa chỉ này. API yêu cầu bạn phải xác nhận quyền sở hữu miền trước khi có thể tạo email đại diện cho người dùng. Email đại diện không được hỗ trợ cho người dùng khách.

Để tạo email đại diện cho người dùng, hãy sử dụng yêu cầu POST sau đây và đưa vào thông tin uỷ quyền được mô tả trong phần Uỷ quyền yêu cầu. userKey có thể là địa chỉ email chính của người dùng, id của người dùng hoặc bất kỳ email nào trong số các email đại diện của người dùng. Để biết các thuộc tính của yêu cầu và phản hồi, hãy xem Tài liệu tham khảo API: 

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

Yêu cầu JSON

Yêu cầu JSON sau đây cho thấy một yêu cầu mẫu để tạo email đại diện cho người dùng. Người dùng là liz@example.com và email đại diện là chica@example.com: 

POST https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases
 Nội dung yêu cầu có thông tin về email đại diện mới: 
{  
 "alias": "chica@example.com"
}

Phản hồi thành công sẽ trả về mã trạng thái HTTP 201. Cùng với mã trạng thái, phản hồi sẽ trả về các thuộc tính cho email đại diện mới của người dùng.

Truy xuất tất cả email đại diện của người dùng

Để truy xuất tất cả email đại diện của người dùng trên tất cả các miền, hãy sử dụng yêu cầu GET sau đây và đưa vào thông tin uỷ quyền được mô tả trong phần Uỷ quyền yêu cầu. userKey có thể là địa chỉ email chính của người dùng, id của người dùng hoặc bất kỳ email nào trong số các email đại diện của người dùng. Để biết các thuộc tính của yêu cầu và phản hồi, hãy xem Tài liệu tham khảo API: 

GET https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases
 Ví dụ: URI yêu cầu này trả về tất cả email đại diện cho userKey, liz@example.com: 
GET https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases

Tất cả email đại diện của người dùng đều được trả về theo thứ tự bảng chữ cái. Không có kích thước trang như chuỗi truy vấn maxResults hoặc phân trang được dùng cho phản hồi "Truy xuất tất cả email đại diện".

Phản hồi JSON

Phản hồi thành công sẽ trả về mã trạng thái HTTP 200. Cùng với mã trạng thái, phản hồi sẽ trả về email đại diện của người dùng theo thứ tự bảng chữ cái. Các miền email đại diện này là miền chính và nhiều miền khác trong tài khoản: 

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

Xoá email đại diện của người dùng

Để xoá email đại diện của người dùng, hãy sử dụng yêu cầu DELETE sau đây và đưa vào thông tin uỷ quyền được mô tả trong phần Uỷ quyền yêu cầu. Có thể mất đến 24 giờ để xoá email đại diện. userKey có thể là địa chỉ email chính của người dùng, id của người dùng hoặc bất kỳ email nào trong số các email đại diện của người dùng. Còn aliasId là địa chỉ email của email đại diện đang bị xoá. Để biết các thuộc tính của yêu cầu và phản hồi, hãy xem Tài liệu tham khảo API. 

DELETE https://admin.googleapis.com/admin/directory/v1/users/userKey/aliases/aliasId
 Ví dụ: yêu cầu DELETE này sẽ xoá email đại diện chica@example.com cho userKey, liz@example.com: 
DELETE https://admin.googleapis.com/admin/directory/v1/users/liz@example.com/aliases/chica@example.com

Phản hồi thành công sẽ trả về mã trạng thái HTTP 200.