친구 피커와 카카오톡 친구 목록 조회 API를 사용하려면 앱에 사용 권한이 필요합니다. 사용 권한이 없는 앱 또는 테스트 앱에서는, 앱의 멤버만 호출할 수 있고 응답 범위도 해당 멤버로 제한됩니다. 사용 권한 획득 후 실제 서비스에서 모든 사용자에게 기능을 제공할 수 있습니다.
사용 권한은 아래 과정으로 신청할 수 있습니다.
- 동의항목을 참고해 [카카오 서비스 내 친구목록(프로필사진, 닉네임, 즐겨찾기 포함)(
friends)] 동의항목을 설정합니다. - 피커 또는 카카오톡 친구 목록 조회 API를 사용한 소셜 기능 구현하고, 앱의 멤버를 대상으로 호출 테스트를 수행합니다.
- 앱 관리 페이지의 [앱] > [추가 기능 신청]에서 실제 동작 화면의 영상 또는 캡처 이미지를 첨부해 사용 권한을 신청합니다.
사용 권한을 받으면 [카카오 서비스 내 친구목록(프로필사진, 닉네임, 즐겨찾기 포함)] 동의항목을 [선택 동의]로 설정할 수 있지만, 피커의 친구 목록과 카카오톡 친구 목록 조회 API의 응답은 친구 정보 제공 조건을 만족하는 친구 정보만 포함하는 점에 유의합니다.
참고: 카카오톡 메시지 사용 권한 신청
카카오톡 메시지 API로 사용자가 친구에게 메시지를 보낼 수 있습니다. 카카오톡 메시지 API로 친구에게 메시지를 보내려면 별도의 사용 권한이 필요하며, 두 기능의 사용 권한을 함께 신청할 수 있습니다.
To use the Friend Picker and the Retrieve list of friends API, the app requires permission. Apps without permission or test apps can only be used by the app’s team members, and the response scope is also limited to those members. After acquiring the permission, the feature can be provided to all users in the actual service.
You can apply for the permissions through the process below.
- Refer to Consent Items and set the consent item for [Friends List in Kakao Service(Including profile image, nickname, and favorites)(
friends)]. - Implement a social feature using the Friend Picker or the Retrieve list of friends API and test the request targeting the app’s team members.
- In [App] > [Request additional features] on the app management page, apply for the permission by attaching video or screenshot of the actual implementation.
After getting permission, the consent item for [Friends List in Kakao Service(Including profile image, nickname, and favorites)] can be set as [Optional consent]. However, note that the responses from both the Friend Picker and Retrieve list of friends API include only friend information that meets the Conditions for providing friends data.
Note: Request permission for the Kakao Talk Message API
Kakao Talk Message API allows users to send a message to their friends. To send a message to a friend using the Kakao Talk Message API, a separate permission is required, and it is possible to request both permissions at once.