Di chuyển từ Dịch vụ miền sang Dịch vụ nâng cao của SDK dành cho quản trị viên

Dịch vụ miền cho phép quản trị viên Google Workspace quản lý người dùng và nhóm đã ngừng hoạt động vào ngày 15 tháng 5 năm 2014 và bị tắt vào ngày 20 tháng 11 năm 2014. Dịch vụ này được thay thế bằng Thư mục Admin SDK và Báo cáo Admin SDK. Trang này trình bày lộ trình di chuyển từ dịch vụ Miền sang Admin SDK.

So sánh phương pháp

Bảng sau đây cung cấp thông tin tổng quan về các phương thức được dùng trong dịch vụ Miền và các phương thức tương đương (nếu có) trong Admin SDK.

Phương thức dịch vụ miền	Phương thức Admin SDK
`DomainGroup.addMember(memberId)`	`AdminDirectory.Members.insert(resource, groupKey)` Trong Admin SDK, bạn có thể chỉ định vai trò của một thành viên trong nhóm thông qua `role`.
`DomainGroup.addOwner(ownerId)`
`DomainGroup.deleteGroup()`	`AdminDirectory.Groups.remove(groupKey)`
`DomainGroup.getAllMembers()`	`AdminDirectory.Members.list(groupKey, optionalArgs)` Trong Admin SDK, (các) chủ sở hữu có thể được liệt kê bằng cách sử dụng tham số `roles` không bắt buộc.
`DomainGroup.getAllOwners()`
`DomainGroup.getDescription()`	`AdminDirectory.Groups.get(groupKey)` Property: `description` Property: `id` Property: `name`
`DomainGroup.getId()`
`DomainGroup.getName()`
`DomainGroup.getPermissionLevel()`	Không áp dụng
`DomainGroup.removeMember(memberId)`	`AdminDirectory.Members.remove(groupKey, memberKey)`
`DomainGroup.removeOwner(ownerId)`	`AdminDirectory.Members.remove(groupKey, memberKey)`
`DomainGroup.setDescription(description)`	`AdminDirectory.Groups.patch(resource, groupKey)` Property: `description` Property: `name`
`DomainGroup.setName(name)`
`DomainGroup.setPermissionLevel(level)`	Không áp dụng
`DomainNickname.deleteNickname()`	`AdminDirectory.Users.Aliases.remove(userKey, alias)`
`DomainNickname.getNickname()`	`AdminDirectory.Users.Aliases.list(userKey, optionalArgs)` Property: `aliases` Property: `primaryEmail`
`DomainNickname.getUsername()`
`DomainUser.deleteUser()`	`AdminDirectory.Users.remove(userKey)`
`DomainUser.getAgreedToTerms()`	`AdminDirectory.Users.get(userKey)` Tài sản: `agreedToTerms` Tài sản: `changePasswordAtNextLogin` Tài sản: `primaryEmail` Tài sản: `name.familyName` Tài sản: `name.givenName` Tài sản: `isAdmin` Tài sản: `suspended`
`DomainUser.getChangePasswordAtNextLogin()`
`DomainUser.getEmail()`
`DomainUser.getFamilyName()`
`DomainUser.getGivenName()`
`DomainUser.getIsAdmin()`
`DomainUser.getIsSuspended()`
`DomainUser.getStorageQuota()`	`AdminReports.UserUsageReport.get(userKey, date, optionalArgs)` Tài khoản: `total_quota_in_mb`
`DomainUser.setChangePasswordAtNext Login(changePassword)`	`AdminDirectory.Users.patch(resource, userKey)` Property: `changePasswordAtNextLogin` Property: `name.familyName` Property: `name.givenName`
`DomainUser.setFamilyName(name)`
`DomainUser.setGivenName(name)`
`DomainUser.setIsAdmin(admin)`	`AdminDirectory.Users.makeAdmin(resource, userKey)` Tài sản: `isAdmin`
`DomainUser.setIsSuspended(suspended)`	`AdminDirectory.Users.patch(resource, userKey)` Property: `suspended` Property: `password` Property: `primaryEmail`
`DomainUser.setPassword(password)`
`DomainUser.setUsername(username)`
`GroupsManager.createGroup(groupId, name, description, permissionLevel)` `GroupsManager.createGroup(groupId, name)`	`AdminDirectory.Groups.insert(resource)` Admin SDK không hỗ trợ việc đặt cấp độ quyền.
`GroupsManager.getAllGroups()` `GroupsManager.getAllGroups(memberId)`	`AdminDirectory.Groups.list(optionalArgs)` Tham số: `userKey`
`GroupsManager.getDomain()` `NicknameManager.getDomain()` `UserManager.getDomain()`	Không áp dụng Để khắc phục, hãy lấy địa chỉ email của một người dùng và trích xuất miền.
`GroupsManager.getGroup(groupId)`	`AdminDirectory.Groups.get(groupKey)`
`NicknameManager.createNickname(username, nickname)`	`AdminDirectory.Users.Aliases.insert(resource, userKey)`
`NicknameManager.getAllNicknames()`	Không áp dụng
`NicknameManager.getAllNicknames(username)`	`AdminDirectory.Users.Aliases.list(userKey, optionalArgs)` Bạn sẽ cần lặp lại các kết quả để tìm biệt hiệu.
`NicknameManager.getNickname(nickname)`
`UserManager.createUser(username, givenName, familyName, password)` `UserManager.createUser(username, givenName, familyName, password, passwordHashFunction)`	`AdminDirectory.Users.insert(resource)` Tài sản: `hashFunction`
`UserManager.getAllUsers()`	`AdminDirectory.Users.list(optionalArgs)` Bạn phải cung cấp tham số `customer` hoặc `domain`. Là quản trị viên tài khoản, bạn cũng có thể sử dụng biệt hiệu `my_customer` để đại diện cho `customerId` của tài khoản.
`UserManager.getUser(user)` `UserManager.getUser(username)`	`AdminDirectory.Users.get(userKey)`

Các tính năng mới trong Admin SDK

Ngoài các phương thức được hỗ trợ nêu trong phần trước, các dịch vụ nâng cao của Admin SDK còn cung cấp những tính năng mới sau:

Tính năng	Lớp hoặc phương thức Admin SDK
Thông báo dành cho quản trị viên	`AdminDirectory.Notifications`
Mật khẩu dành riêng cho ứng dụng	`AdminDirectory.Asps`
Quản lý thiết bị	`AdminDirectory.Chromeosdevices` `AdminDirectory.Mobiledevices`
Bí danh nhóm	`AdminDirectory.Groups.Aliases`
Mã thông báo OAuth	`AdminDirectory.Tokens`
Đơn vị tổ chức	`AdminDirectory.Orgunits`
Báo cáo	`AdminReports`
Tìm người dùng	`AdminDirectory.Users.list(optionalArgs)` Tham số: `query`
Huỷ xoá người dùng	`AdminDirectory.Users.undelete()`
Dữ liệu người dùng	`AdminDirectory.Users.get(userKey)`
Ảnh người dùng	`AdminDirectory.Users.Photos.get(userKey)`
Mã xác minh (xác thực 2 yếu tố)	`AdminDirectory.VerificationCodes`

Di chuyển từ Dịch vụ miền sang Dịch vụ nâng cao của SDK dành cho quản trị viên Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

So sánh phương pháp

Các tính năng mới trong Admin SDK

Di chuyển từ Dịch vụ miền sang Dịch vụ nâng cao của SDK dành cho quản trị viên