Directory API là một phần của API SDK dành cho quản trị viên RESTful có thể dùng để 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 một 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à thực hiện hành động trên thiết bị thất lạc.
- 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ữ phổ biến được sử dụng trong API Thư mục:
- Khách hàng
- Pháp nhân sở hữu tài khoản Google Workspace, do tài nguyên Khách hàng đại diện.
- Miền
- Nếu có, miền DNS liên kết với một tài khoản Google Workspace, đượ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 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 đại diện 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
Để tìm hiểu về cách phát triển bằng API Google Workspace, bao gồm cả việc xử lý xác thực và uỷ quyền, hãy tham khảo bài viết Bắt đầu làm nhà phát triển Workspace.
Để tìm hiểu cách định cấu hình và chạy một ứng dụng Directory API đơn giản, hãy thử bài viết hướng dẫn nhanh về JavaScript.