Tổng quan về API thư mục

API Thư mục là một phần của API SDK quản trị RESTful. Bạn có thể dùng API này để tạo và quản lý các tài nguyên do quản trị viên kiểm soát thuộc sở hữu của tài khoản Google Workspace theo phương thức lập trình. Một số trường hợp sử dụng bao gồm:

  • Tạo và quản lý người dùng cũng như thêm quản trị viên.
  • Tạo và quản lý nhóm cũng như tư cách thành viên trong nhóm.
  • Giám sát các thiết bị được kết nối với miền của bạn và xử lý các thiết bị bị mất.
  • Quản lý sơ đồ tổ chức và cấu trúc tổ chức.
  • Kiểm tra các ứng dụng mà người dùng đã cấp quyền truy cập và thu hồi quyền truy cập của các ứng dụng trái phép.

Sau đây là danh sách các thuật ngữ thường dùng trong Directory API:

Khách hàng
Pháp nhân sở hữu tài khoản Google Workspace, được biểu thị bằng tài nguyên Khách hàng.
Miền
Miền DNS được liên kết với một tài khoản Google Workspace (nếu có), được biểu thị bằng tài nguyên Miền. Không phải tài khoản nào cũng có miền được liên kết.
Đơn vị tổ chức (OU)
Một đơn vị phụ trong cây tổ chức của tài khoản Google Workspace, dùng để nhóm và sắp xếp người dùng nhằm mục đích áp dụng chính sách và cấp quyền. OU được biểu thị bằng tài nguyên OrgUnit.
Đặc quyền
Khả năng của người dùng trong việc thực hiện một hành động trên tài nguyên Google Workspace. Chủ yếu áp dụng cho quản trị viên. Một đặc quyền được biểu thị bằng tài nguyên Đặc quyền.
Vai trò
Một tập hợp các đặc quyền được xác định có thể được chỉ định cho một người dùng hoặc một nhóm người dùng, được biểu thị bằng tài nguyên Vai trò.
Chỉ định vai trò
Một bản ghi cho biết người dùng nào được cấp vai trò nào và trong phạm vi nào. Việc chỉ định vai trò được biểu thị bằng tài nguyên RoleAssignment.
Giản đồ
Đối tượng JSON xác định các thuộc tính người dùng tuỳ chỉnh cho tổ chức của bạn, được biểu thị bằng tài nguyên Schema.
Người dùng
Một tài khoản người dùng cuối cá nhân có quyền truy cập vào các ứng dụng và tài nguyên của Google Workspace, được biểu thị bằng tài nguyên Người dùng.

Các bước tiếp theo