Quản lý người được ủy quyền liên hệ

Hướng dẫn này trình bày cách tạo, liệt kê và xoá người được uỷ quyền truy cập vào danh bạ cho người dùng Google Workspace.

Người dùng Google Workspace có thể cấp cho người dùng khác trong miền của họ quyền truy cập và quản lý danh bạ của mình. Những người được uỷ quyền này có thể thêm và cập nhật thông tin như tên, số điện thoại và địa chỉ trong danh bạ đó.

Hướng dẫn này dành cho việc uỷ quyền truy cập vào danh bạ. Để uỷ quyền truy cập vào Gmail, hãy xem bài viết Uỷ quyền và cộng tác trên email.

Điều kiện tiên quyết

Trước khi sử dụng Contact Delegation API, hãy đảm bảo rằng bạn đáp ứng các yêu cầu sau:

  • Bật tính năng chia sẻ danh bạ: Quản trị viên Thư mục phải bật tính năng chia sẻ danh bạ trong Bảng điều khiển dành cho quản trị viên. Để biết thêm thông tin, hãy xem bài viết Bật hoặc tắt tính năng chia sẻ danh bạ.
  • Quyền quản trị viên: Bạn phải có quyền quản trị viên "Danh bạ" để quản lý người được uỷ quyền cho người dùng khác.
  • Giới hạn về miền: Bạn chỉ có thể uỷ quyền truy cập vào danh bạ giữa những người dùng trong cùng một tổ chức Google Workspace.
  • Phạm vi OAuth: Ứng dụng của bạn phải sử dụng phạm vi OAuth sau: https://www.googleapis.com/auth/admin.contact.delegation.

Tạo người được uỷ quyền

Để tạo người được uỷ quyền cho một người dùng, hãy gửi yêu cầu POST bằng địa chỉ email của người uỷ quyền:

POST https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates

Thay thế USER_EMAIL bằng địa chỉ email của người uỷ quyền.

Trong nội dung yêu cầu, hãy cung cấp địa chỉ email cho người được uỷ quyền:

{
  "email": "DELEGATE_EMAIL"
}

Thay thế DELEGATE_EMAIL bằng địa chỉ email của người được uỷ quyền.

Phản hồi thành công sẽ trả về mã trạng thái HTTP 200 và email của người được uỷ quyền mới:

{
  "email": "DELEGATE_EMAIL"
}

Liệt kê người được uỷ quyền

Để liệt kê người được uỷ quyền cho danh bạ của một người dùng, hãy gửi yêu cầu GET bằng địa chỉ email của người dùng đó:

GET https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates

Thay thế USER_EMAIL bằng địa chỉ email của người dùng.

Phản hồi thành công sẽ trả về mã trạng thái HTTP 200 và danh sách email của người được uỷ quyền:

{
  "delegates": [
    {
      "email": "DELEGATE_EMAIL_1"
    },
    {
      "email": "DELEGATE_EMAIL_2"
    }
  ]
}

Xoá người được uỷ quyền

Để xoá người được uỷ quyền cho danh bạ của một người dùng, hãy hoàn tất các bước sau:

  1. Xác định người được uỷ quyền cần xoá. Sử dụng phương thức Liệt kê người được uỷ quyền để tìm địa chỉ email của một người được uỷ quyền cụ thể.

  2. Gửi yêu cầu DELETE bằng địa chỉ email của người uỷ quyền và người được uỷ quyền:

    DELETE https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates/DELEGATE_EMAIL

Thay thế USER_EMAIL bằng địa chỉ email của người uỷ quyền và DELEGATE_EMAIL bằng địa chỉ email của người được uỷ quyền.

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