API thư mục 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 theo phương thức lập trình thuộc sở hữu của một Tài khoản Google Workspace. Có thể kể đến một số trường hợp sử dụng như sau:
- 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ư 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ý khi thiết bị thất lạc thiết bị.
- Quản lý sơ đồ tổ chức và cơ cấu tổ chức của bạn.
- Kiểm tra các ứng dụng mà người dùng của bạn đã cấp quyền truy cập và thu hồi ứng dụng trái phép.
Sau đây là danh sách các thuật ngữ phổ biến được 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 dành cho khách hàng.
- Miền
- Nếu có thì miền DNS liên kết với tài khoản Google Workspace, được biểu thị bằng Tài nguyên Miền. Không phải tất cả đều có miền liên kết.
- Đơn vị tổ chức (OU)
- Một đơn vị con trong sơ đồ tổ chức của tài khoản Google Workspace, dùng để nhóm và sắp xếp người dùng để áp dụng chính sách và cấp uỷ quyền. Đơn vị tổ chức được đại diện bằng Tài nguyên OrgUnit.
- Đặc quyền
- Khả năng người dùng thực hiện một hành động trên một tài nguyên của Google Workspace. Áp dụng chủ yếu cho quản trị viên. Đặc quyền được biểu thị bằng Đặc quyền tài nguyên.
- Vai trò
- Một tập hợp đặc quyền xác định mà có thể được chỉ định cho một người dùng hoặc một nhóm người dùng, được đại diện bằng Tài nguyên về Vai trò.
- Chỉ định vai trò
- Bản ghi cho biết người dùng nào được cấp vai trò nào và thuộc phạm vi nào. Việc chỉ định vai trò được thể hiện bằng RoleAssignment tài nguyên.
- Giản đồ
- Đối tượng JSON xác định 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 giản đồ.
- User
- 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 của Google Workspace và đượ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 của Google Workspace, bao gồm cả cách xử lý xác thực và uỷ quyền, hãy tham khảo Bắt đầu với vai trò là 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 API Thư mục đơn giản, hãy thử Bắt đầu nhanh JavaScript.