도메인 서비스에서 Admin SDK 고급 서비스로 마이그레이션

G Suite 도메인 관리자가 사용자 및 그룹을 관리할 수 있는 도메인 서비스는 2014년 5월 15일부로 지원 중단되었으며 2014년 11월 20일에 사용 중지됩니다. 이 서비스는 최근에 추가된 Admin SDK 디렉터리 및 Admin SDK 보고서 고급 서비스로 대체됩니다. 이 페이지에서는 도메인 서비스에서 새로운 대체인 Admin SDK로의 마이그레이션 경로를 간략히 설명합니다.

메서드 비교

아래 표에는 도메인 서비스에서 사용되는 메서드와 Admin SDK에서 이와 동등한 메서드 (있는 경우)가 간략하게 나와 있습니다.

도메인 서비스 방법 Admin SDK 메서드
DomainGroup.addMember(memberId) AdminDirectory.Members.insert(resource, groupKey)
Admin SDK에서 그룹의 구성원 역할은 role를 통해 지정할 수 있습니다.
DomainGroup.addOwner(ownerId)
DomainGroup.deleteGroup() AdminDirectory.Groups.remove(groupKey)
DomainGroup.getAllMembers() AdminDirectory.Members.list(groupKey, optionalArgs)
Admin SDK에서 소유자는 선택사항인 roles 매개변수를 사용하여 나열할 수 있습니다.
DomainGroup.getAllOwners()
DomainGroup.getDescription() AdminDirectory.Groups.get(groupKey)
속성: description
속성: id
속성: name
DomainGroup.getId()
DomainGroup.getName()
DomainGroup.getPermissionLevel() N/A
DomainGroup.removeMember(memberId) AdminDirectory.Members.remove(groupKey, memberKey)
DomainGroup.removeOwner(ownerId)
DomainGroup.setDescription(description) AdminDirectory.Groups.patch(resource, groupKey)
속성: description
속성: name
DomainGroup.setName(name)
DomainGroup.setPermissionLevel(level) N/A
DomainNickname.deleteNickname() AdminDirectory.Users.Aliases.remove(userKey, alias)
DomainNickname.getNickname() AdminDirectory.Users.Aliases.list(userKey, optionalArgs)
속성: aliases
속성: primaryEmail
DomainNickname.getUsername()
DomainUser.deleteUser() AdminDirectory.Users.remove(userKey)
DomainUser.getAgreedToTerms() AdminDirectory.Users.get(userKey)
속성: agreedToTerms
속성: changePasswordAtNextLogin
속성: primaryEmail
속성: name.familyName
속성: name.givenName
속성: isAdmin
속성: suspended
DomainUser.getChangePasswordAtNextLogin()
DomainUser.getEmail()
DomainUser.getFamilyName()
DomainUser.getGivenName()
DomainUser.getIsAdmin()
DomainUser.getIsSuspended()
DomainUser.getStorageQuota() AdminReports.UserUsageReport.get(userKey, date, optionalArgs)
계정: total_quota_in_mb
DomainUser.setChangePasswordAtNext Login(changePassword) AdminDirectory.Users.patch(resource, userKey)
속성: changePasswordAtNextLogin
속성: name.familyName
속성: name.givenName
DomainUser.setFamilyName(name)
DomainUser.setGivenName(name)
DomainUser.setIsAdmin(admin) AdminDirectory.Users.makeAdmin(resource, userKey)
속성: isAdmin
DomainUser.setIsSuspended(suspended) AdminDirectory.Users.patch(resource, userKey)
속성: suspended
속성: password
속성: primaryEmail
DomainUser.setPassword(password)
DomainUser.setUsername(username)
GroupsManager.createGroup(groupId, name, description, permissionLevel) GroupsManager.createGroup(groupId, name) AdminDirectory.Groups.insert(resource)
Admin SDK에서는 권한 수준 설정이 지원되지 않습니다.
GroupsManager.getAllGroups()
GroupsManager.getAllGroups(memberId)		 AdminDirectory.Groups.list(optionalArgs)
매개변수: userKey
GroupsManager.getDomain()
NicknameManager.getDomain()
UserManager.getDomain() 		해당 사항 없음
이 문제를 해결하려면 단일 사용자의 이메일 주소를 가져오고 도메인을 추출합니다.
GroupsManager.getGroup(groupId) AdminDirectory.Groups.get(groupKey)
NicknameManager.createNickname(username, nickname) AdminDirectory.Users.Aliases.insert(resource, userKey)
NicknameManager.getAllNicknames() N/A
NicknameManager.getAllNicknames(username) AdminDirectory.Users.Aliases.list(userKey, optionalArgs)
닉네임을 찾으려면 결과를 반복해야 합니다.
NicknameManager.getNickname(nickname)
UserManager.createUser(username, givenName, familyName, password) UserManager.createUser(username, givenName, familyName, password, passwordHashFunction) AdminDirectory.Users.insert(resource)
속성: hashFunction
UserManager.getAllUsers() AdminDirectory.Users.list(optionalArgs)
customer 또는 domain 매개변수를 제공해야 합니다. 계정 관리자는 my_customer 별칭을 사용하여 계정의 customerId을 나타낼 수도 있습니다.
UserManager.getUser(user)
UserManager.getUser(username)		 AdminDirectory.Users.get(userKey)

Admin SDK의 새로운 기능

Admin SDK 고급 서비스는 위에서 설명한 지원되는 방법 외에도 다음과 같은 새로운 기능을 제공합니다.

기능 Admin SDK 클래스 또는 메서드
관리자 알림 AdminDirectory.Notifications
애플리케이션 비밀번호 AdminDirectory.Asps
기기 관리 AdminDirectory.Chromeosdevices
AdminDirectory.Mobiledevices
그룹 별칭 AdminDirectory.Groups.Aliases
OAuth 토큰 AdminDirectory.Tokens
조직 단위 AdminDirectory.Orgunits
보고서 AdminReports
사용자 검색 AdminDirectory.Users.list(optionalArgs)
매개변수: query
사용자 삭제 취소 AdminDirectory.Users.undelete()
사용자 데이터 AdminDirectory.Users.get(userKey)
사용자 사진 AdminDirectory.Users.Photos.get(userKey)
인증 코드 (2단계) AdminDirectory.VerificationCodes