[공지] 친구 목록 가져오기 API 친구 정보 제공 정책 및 응답 변경 안내 / [Change Notice] Response of Retrieving list of friends API

안녕하세요, 카카오입니다.

사용자가 친구 목록에서 자신을 노출할 것인지 설정할 수 있는 프로필 공개 설정 기능이 추가되었습니다.
해당 기능 추가에 따라, 친구 목록 가져오기 API를 통한 친구 정보 제공 정책 및 응답에 변경 사항이 발생하여 안내 드립니다.

적용 일시

  • 2022년 5월 17일

기능 소개

  • 프로필 공개 설정: 사용자가 API를 통해 앱에 제공되는 친구 목록에 자신을 노출할 것인지 설정 가능
    • 공개: 앱의 친구 목록에 노출 허용
    • 비공개: 앱의 친구 목록에 노출 비허용
    • 기존의 메시지 수신 설정이 프로필 공개 설정으로 변경되는 것으로,
      사용자는 프로필 비공개를 통해 친구 목록에서의 노출과 메시지 수신을 모두 거부할 수 있음

변경사항

  • 카카오톡 소셜 > 친구 목록 가져오기 API
    • 응답의 친구 목록에 프로필 비공개로 설정한 사용자 미포함
    • 프로필 공개로 설정되어 메시지 전송이 가능한 친구만 응답에 포함되므로,
      메시지 차단 여부(allowed_msg) 필드는 true 값만 반환하게 되어 제공 종료 예정(Deprecated)
  • 카카오톡 메시지 API
    • 친구 목록 가져오기를 통해 프로필 비공개인 사용자의 uuid를 제공받을 수 없으므로
      해당 사용자 대상 메시지 발송 불가

권장사항

  • 친구 목록 가져오기 API의 응답 중 메시지 차단 여부(allowed_msg)를 더 이상 사용하지 않도록 변경
    • 메시지를 보낼 수 없는 친구가 응답에 포함되지 않으므로, 해당 필드를 참고하여 친구 목록에서 비노출하는 예외 처리 불필요

참고

  • 친구 목록 가져오기 API 개발 가이드
  • 친구 정보 제공 조건
  • 프로필 공개 설정의 위치
    • 카카오톡 메시지 API로 발송된 메시지 말풍선 하단의 [설정] 버튼
    • 카카오톡 [설정] > [카카오계정] > [연결된 서비스 관리]

프로필 공개 설정 위치

언제나 더 좋은 서비스를 제공하기 위해 최선을 다 하겠습니다.

감사합니다.




Hello. It’s kakao.

We have an announcement on some changes in the response of Retrieving list of friends API as the profile visibility option is provided. This new option allows users to set whether to hide or show their profile on the list of friends of your service. From May 17, 2202, the users who set their profile to private for the service with this option will be excluded from the response of the Retrieving list of friends API.

Effective date

  • Tuesday, May 17, 2022

Changes

  • The option to allow or block messages from service is replaced with the profile visibility option.
  • The new option affects the response of Retrieving list of friends API, not including the users who to set to hide their profile.
Change Before After
Option name Receive messages from this service Show my profile on Friends list
Option function Users can allow or block messages form their friends in thier service. Users can show or hide their profiles on the Friends list and allow or block messages form their friends in thier service.
If the option is disabled The user’s friends cannot send any messages. The user’s profile is not displayed on the Friends list and the user’s friends cannot send any messages.
Response of the Retrieving list of friends API Include the user with this option disabled, and return allowed_msg=false for the user. Not include the users with this option disabled.
Return only user information with allowed_msg=true.

NOTE: allowed_msg has been deprecated since this field is no more meaningful after the change.

Recommended actions

  • Change the source code not to use the response field, allowed_msg.
  • Consider the case that the users who are set to private in the Friends list are not included in the response of the Retrieving list of friends API, and take action in your service.

Reference


If you have any further question about the changes above, contact us at DevTalk.
We always do our best to provide a better service.

Thank you.