이 문서는 Partner Android SDK(Kakao Partner SDK for Android)로 사용자 정보 API 사용 방법을 안내합니다. 사용자 정보 API는 카카오 로그인 모듈에 포함되어 제공됩니다.

현재 로그인한 사용자의 카카오계정 정보를 불러옵니다.

meForPartner()를 호출합니다.

성공 시 PartnerUser 객체로 사용자 정보를 받습니다. 응답에 파트너용 추가 정보들을 제공합니다. 응답 일부는 권한이 필요하므로 권한 신청 필요 항목: API를 참고합니다. 자세한 응답 정보는 REST API를 참고합니다.

UserApiClient.instance.meForPartner { user, error ->
    if (error != null) {
        Log.e(TAG, "사용자 정보 요청 실패", error)
    } else {
        Log.i(TAG, "사용자 정보 요청 성공" +
                "\n회원번호: ${user.id}" +
                "\n연결여부: ${user.hasSignedUp}")
    }
}

요청 시 응답에 포함할 사용자 정보의 키를 propertyKeys 파라미터로 지정할 수 있습니다. 사용자 정보를 지정해 요청할 경우, 해당 정보만 응답에 포함됩니다.

사용자 프로퍼티에 값을 저장합니다.

자세한 안내와 예제는 사용자 프로퍼티 저장을 참고합니다.

사용자 카카오계정의 배송지 정보를 제공합니다. 배송지에서 자세한 안내를 확인한 후 사용할 것을 권장합니다.

카카오 로그인으로 토큰을 발급받은 후, 아래의 두 API를 순서대로 호출해 배송지 정보를 제공받을 수 있습니다.

1. 배송지 선택
2. 배송지 조회

사용자가 서비스에 제공할 배송지를 직접 선택할 수 있는 배송지 피커를 불러오고, 선택된 배송지의 ID를 제공합니다.

자세한 안내와 예제는 배송지 선택을 참고합니다.

사용자가 카카오계정에 새로운 배송지를 등록할 수 있는 배송지 피커를 불러오고, 추가된 배송지의 ID를 제공합니다.

자세한 안내와 예제는 배송지 조회를 참고합니다.

사용자가 카카오계정에 새로운 배송지를 등록할 수 있는 배송지 피커를 불러오고, 추가된 배송지의 ID를 제공합니다. 이 기능을 사용하면 배송지 선택 과정 없이 곧바로 사용자에게 배송지 등록을 요청할 수 있습니다. 자세한 안내는 배송지를 참고합니다.

배송지 등록은 추가된 배송지의 ID만 제공하므로, 추가된 배송지 상세 정보를 받으려면 아래 두 가지 함수를 순서대로 요청해야 합니다.

1. 배송지 등록
2. 배송지 조회

createShippingAddress() 메서드를 호출합니다.

사용자가 배송지 피커에서 새로운 배송지 등록을 완료하면, 추가된 배송지의 ID가 반환됩니다. 반환된 배송지 ID로 배송지 조회를 요청해 배송지 상세 정보를 제공받을 수 있습니다.

에러 발생 시 에러 코드에서 원인을 확인합니다.

UserApiClient.instance.createShippingAddress(requireContext()) { addressId, error ->
    if(error != null) {
        Log.i(TAG, "배송지 추가 실패 $error")
        return@createShippingAddress
    }

    Log.i(TAG, "배송지 추가 성공 $addressId")
}

사용자가 카카오계정에 등록된 배송지를 수정할 수 있는 배송지 피커를 불러오고, 수정된 배송지의 ID를 제공합니다. 이 기능을 사용하려면 권한 및 동의항목 설정이 필요합니다. 자세한 안내는 배송지를 참고합니다.

배송지 수정은 수정된 배송지의 ID만 제공하므로, 수정된 배송지 상세 정보를 받으려면 아래 두 가지 함수를 순서대로 요청해야 합니다.

1. 배송지 수정
2. 배송지 조회

updateShippingAddress() 메서드를 호출합니다. 요청 시 addressId 파라미터로 수정할 배송지를 지정해야 합니다.

사용자가 배송지 피커에서 수정을 완료하면, 수정된 배송지의 ID가 반환됩니다. 반환된 배송지 ID로 배송지 조회 API를 요청해 수정된 최신 배송지 정보를 제공받을 수 있습니다.

에러 발생 시 에러 코드에서 원인을 확인합니다.

UserApiClient.instance.updateShippingAddress(requireContext(), addressId) { updatedAddressId, err ->
    if (err != null) {
        Log.i(TAG, "배송지 수정 실패 $err")
        return@updateShippingAddress
    }

    Log.i(TAG, "배송지 수정 성공 $updatedAddressId")
}