KOUserMeAccount Class Reference

Inherits from NSObject
Conforms to NSCopying
Declared in KOUserMe.h

Overview

이 클래스에서 제공하는 카카오계정의 모든 개인정보는 사용자의 동의를 받지 않은 경우 nil이 반환됩니다.
개인정보 필드의 값이 없으면 해당 필드와 매칭되는 {property}NeedsAgreement 속성 값을 확인하여 사용자에게 정보 제공에 대한 동의를 요청하고 정보 획득을 시도해 볼 수 있습니다.
{property}NeedsAgreement 값이 true인 경우 새로운 동의 요청이 가능한 상태이며 KOSession의 updateScopes 메소드를 이용하여 동의를 받을 수 있습니다. 동의를 받은 후 user/me를 다시 호출하면 해당 값이 반환될 것입니다.
{property}NeedsAgreement 값이 false인 경우 사용자의 계정에 해당 정보가 없어서 값을 얻을 수 없음을 의미합니다.

  email

카카오계정에 등록한 이메일 정보

@property (readonly, nullable) NSString *email

Discussion

이메일은 사용자의 동의를 받지 않은 경우 nil이 반환됩니다.
이메일이 nil이면 emailNeedsAgreement 속성 값을 확인하여 사용자에게 정보 제공에 대한 동의를 요청하고 정보 획득을 시도해 볼 수 있습니다.
동의를 받은 후 user/me를 다시 호출하면 이메일 값이 반환됩니다.

Declared In

KOUserMe.h

  isEmailVerified

카카오계정에 이메일 등록 시 이메일 인증을 받았는지 여부

@property (readonly) KOOptionalBoolean isEmailVerified

See Also

Declared In

KOUserMe.h

  emailNeedsAgreement

이메일 제공에 대한 사용자 동의 필요 여부

@property (readonly) BOOL emailNeedsAgreement

Discussion

emailNeedsAgreement 값이 true인 경우 새로운 동의 요청이 가능한 상태이며 KOSession의 updateScopes 메소드를 이용하여 동의를 받을 수 있습니다.
updateScopes의 파라미터로 전달할 이메일 동의항목에 대한 scope ID는 “account_email"입니다.
emailNeedsAgreement 값이 false인 경우 사용자의 계정에 이메일 정보가 없어서 값을 얻을 수 없음을 의미합니다.

See Also

Declared In

KOUserMe.h

  isKakaotalkUser

카카오톡 서비스 가입 여부

@property (readonly) KOOptionalBoolean isKakaotalkUser

Discussion

제휴를 통해 권한이 부여된 특정 앱에서만 획득할 수 있습니다. 제휴되어 있지 않은 경우 null이 반환됩니다.
카카오톡 카카오계정 설정에 연결되어 있는 카카오계정은 true가 반환됩니다.
사용자에게 동의를 받지 않았을 경우 null이 반환되며 KOSession의 updateScopes 메소드를 이용하여 사용자로부터 카카오톡 가입 여부에 대한 동의를 받을 수 있습니다.
카카오톡 서비스 가입 여부 scope ID는 “is_kakaotalk_user"입니다.

Declared In

KOUserMe.h

  phoneNumber

카카오톡에서 인증한 전화번호

@property (readonly, nullable) NSString *phoneNumber

Discussion

제휴를 통해 권한이 부여된 특정 앱에서만 획득할 수 있습니다. 카카오톡에 연결되어 있지 않은 카카오계정은 전화번호가 존재하지 않습니다.
phoneNumber는 사용자의 동의를 받지 않은 경우 nil이 반환됩니다.
phoneNumber가 nil이면 phoneNumberNeedsAgreement 속성 값을 확인하여 사용자에게 정보 제공에 대한 동의를 요청하고 정보 획득을 시도해 볼 수 있습니다.
동의를 받은 후 user/me를 다시 호출하면 phoneNumber 값이 반환됩니다.

Declared In

KOUserMe.h

  phoneNumberNeedsAgreement

phoneNumber 제공에 대한 사용자 동의 필요 여부

@property (readonly) BOOL phoneNumberNeedsAgreement

Discussion

phoneNumberNeedsAgreement 값이 true인 경우 새로운 동의 요청이 가능한 상태이며 KOSession의 updateScopes 메소드를 이용하여 동의를 받을 수 있습니다.
updateScopes의 파라미터로 전달할 phoneNumber 동의항목에 대한 scope ID는 “phone_number"입니다.
phoneNumberNeedsAgreement 값이 false인 경우 사용자의 계정에 phoneNumber 정보가 없어서 값을 얻을 수 없음을 의미합니다.

Declared In

KOUserMe.h

  displayID

카카오계정의 대표 정보. 이메일 또는 전화번호

@property (readonly, nullable) NSString *displayID

Discussion

제휴를 통해 권한이 부여된 특정 앱에서만 획득할 수 있습니다. 계정 상태에 이상이 생긴 경우 텍스트 일부가 마스킹 처리되어 반환됩니다.

Declared In

KOUserMe.h

  ageRange

사용자의 연령대 정보

@property (readonly) KOUserAgeRange ageRange

Discussion

카카오계정에 등록된 사용자의 생일 정보를 기반으로 제공됩니다.
ageRange는 사용자의 동의를 받지 않은 경우 nil이 반환됩니다.
ageRange가 nil이면 ageRangeNeedsAgreement 속성 값을 확인하여 사용자에게 정보 제공에 대한 동의를 요청하고 정보 획득을 시도해 볼 수 있습니다.
동의를 받은 후 user/me를 다시 호출하면 ageRange 값이 반환됩니다.

Declared In

KOUserMe.h

  ageRangeNeedsAgreement

ageRange 제공에 대한 사용자 동의 필요 여부

@property (readonly) BOOL ageRangeNeedsAgreement

Discussion

ageRangeNeedsAgreement 값이 true인 경우 새로운 동의 요청이 가능한 상태이며 KOSession의 updateScopes 메소드를 이용하여 동의를 받을 수 있습니다.
updateScopes의 파라미터로 전달할 ageRange 동의항목에 대한 scope ID는 “age_range"입니다.
ageRangeNeedsAgreement 값이 false인 경우 사용자의 계정에 ageRange 정보가 없어서 값을 얻을 수 없음을 의미합니다.

Declared In

KOUserMe.h

  birthyear

사용자의 출생 연도

@property (readonly, nullable) NSString *birthyear

Discussion

카카오계정에 등록된 사용자의 출생 연도 정보를 기반으로 제공됩니다. (yyyy형식)
birthyear는 사용자의 동의를 받지 않은 경우 nil이 반환됩니다.
birthyear가 nil이면 birthyearNeedsAgreement 속성 값을 확인하여 사용자에게 정보 제공에 대한 동의를 요청하고 정보 획득을 시도해 볼 수 있습니다.
동의를 받은 후 user/me를 다시 호출하면 birthyear 값이 반환됩니다.

Declared In

KOUserMe.h

  birthyearNeedsAgreement

birthyear 제공에 대한 사용자 동의 필요 여부

@property (readonly) BOOL birthyearNeedsAgreement

Discussion

birthyearNeedsAgreement 값이 true인 경우 새로운 동의 요청이 가능한 상태이며 KOSession의 updateScopes 메소드를 이용하여 동의를 받을 수 있습니다.
updateScopes의 파라미터로 전달할 birthyear 동의항목에 대한 scope ID는 “birthyear"입니다.
birthyearNeedsAgreement 값이 false인 경우 사용자의 계정에 birthyear 정보가 없어서 값을 얻을 수 없음을 의미합니다.

Declared In

KOUserMe.h

  birthday

사용자의 생일

@property (readonly, nullable) NSString *birthday

Discussion

카카오계정에 등록된 사용자의 생일 정보를 기반으로 제공됩니다. (MMDD형식)
birthday는 사용자의 동의를 받지 않은 경우 nil이 반환됩니다.
birthday가 nil이면 birthdayNeedsAgreement 속성 값을 확인하여 사용자에게 정보 제공에 대한 동의를 요청하고 정보 획득을 시도해 볼 수 있습니다.
동의를 받은 후 user/me를 다시 호출하면 birthday 값이 반환됩니다.

Declared In

KOUserMe.h

  birthdayNeedsAgreement

birthday 제공에 대한 사용자 동의 필요 여부

@property (readonly) BOOL birthdayNeedsAgreement

Discussion

birthdayNeedsAgreement 값이 true인 경우 새로운 동의 요청이 가능한 상태이며 KOSession의 updateScopes 메소드를 이용하여 동의를 받을 수 있습니다.
updateScopes의 파라미터로 전달할 birthday 동의항목에 대한 scope ID는 “birthday"입니다.
birthdayNeedsAgreement 값이 false인 경우 사용자의 계정에 birthday 정보가 없어서 값을 얻을 수 없음을 의미합니다.

Declared In

KOUserMe.h

  gender

사용자의 생일

@property (readonly) KOUserGender gender

Discussion

카카오계정에 등록된 사용자의 성별 정보가 제공됩니다.
gender는 사용자의 동의를 받지 않은 경우 nil이 반환됩니다.
gender가 nil이면 genderNeedsAgreement 속성 값을 확인하여 사용자에게 정보 제공에 대한 동의를 요청하고 정보 획득을 시도해 볼 수 있습니다.
동의를 받은 후 user/me를 다시 호출하면 gender 값이 반환됩니다.

Declared In

KOUserMe.h

  genderNeedsAgreement

gender 제공에 대한 사용자 동의 필요 여부

@property (readonly) BOOL genderNeedsAgreement

Discussion

genderNeedsAgreement 값이 true인 경우 새로운 동의 요청이 가능한 상태이며 KOSession의 updateScopes 메소드를 이용하여 동의를 받을 수 있습니다.
updateScopes의 파라미터로 전달할 gender 동의항목에 대한 scope ID는 “gender"입니다.
genderNeedsAgreement 값이 false인 경우 사용자의 계정에 gender 정보가 없어서 값을 얻을 수 없음을 의미합니다.

See Also

Declared In

KOUserMe.h

  ci

사용자의 생일

@property (readonly, nullable) NSString *ci

Discussion

카카오계정에 등록된 사용자의 ci가 제공됩니다. (base64형식)
ci는 사용자의 동의를 받지 않은 경우 nil이 반환됩니다.
ci가 nil이면 ciNeedsAgreement 속성 값을 확인하여 사용자에게 정보 제공에 대한 동의를 요청하고 정보 획득을 시도해 볼 수 있습니다.
동의를 받은 후 user/me를 다시 호출하면 ci 값이 반환됩니다.

Declared In

KOUserMe.h

  ciNeedsAgreement

ci 제공에 대한 사용자 동의 필요 여부

@property (readonly) BOOL ciNeedsAgreement

Discussion

ciNeedsAgreement 값이 true인 경우 새로운 동의 요청이 가능한 상태이며 KOSession의 updateScopes 메소드를 이용하여 동의를 받을 수 있습니다.
updateScopes의 파라미터로 전달할 ci 동의항목에 대한 scope ID는 “ci"입니다.
ciNeedsAgreement 값이 false인 경우 사용자의 계정에 ci 정보가 없어서 값을 얻을 수 없음을 의미합니다.

See Also

Declared In

KOUserMe.h

  ciAuthenticatedAt

사용자가 ci를 획득한 시간.

@property (readonly, nullable) NSDate *ciAuthenticatedAt

Discussion

카카오계정에 등록된 사용자의 ci획득시간이 제공됩니다.

See Also

Declared In

KOUserMe.h