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 SDK dành cho quản trị viên và Báo cáo SDK dành cho quản trị viên. Trang này trình bày lộ trình di chuyển từ dịch vụ Miền sang SDK dành cho quản trị viên.

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 SDK dành cho quản trị viên.

Phương thức dịch vụ miền Phương thức SDK dành cho quản trị viên
DomainGroup.addMember(memberId) AdminDirectory.Members.insert(resource, groupKey)
Trong SDK dành cho quản trị viên, 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 SDK dành cho quản trị viên, (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)
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)
SDK dành cho quản trị viên 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 SDK dành cho quản trị viên 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