[공지] 카카오 로그인 사용자 프로퍼티 프로필 제공 정책 변경 / [Notice] Policy change on the user properties related to Kakao Login user's profile

Notice / 공지
1

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

2022년 5월 12일부터 사용자 프로퍼티 프로필 제공 기능 정책이 변경될 예정입니다.

사용자 프로퍼티는 서비스의 정보를 카카오 플랫폼에 저장할 수 있는 기능으로,
기본으로 제공되는 프로필 정보인 프로필 닉네임과 사진, 썸네일 이미지를 포함합니다.

사용자 프로퍼티의 프로필 정보는 사용자가 서비스에 연결하는 시점의 카카오계정 프로필을 복사하여 기본으로 제공되었고,
사용자 정보 저장하기 API를 통해 서비스의 프로필로 업데이트하는 기능도 제공하였으나,
앞으로는 카카오계정의 실시간 프로필만 제공하는 것으로 정책을 변경하고자 합니다.

사용자 프로퍼티에 서비스의 프로필 정보를 업데이트하여 사용 중인 서비스는 영향이 있을 수 있으니,
아래 변경 사항을 확인하여 조치해야 합니다.

적용 일자

  • 2022년 5월 12일(목)

변경 사항

  • 사용자 프로퍼티 중 기본 제공 프로퍼티인 프로필의 기본값 및 갱신(변경) 방법 변경
    • 대상 프로퍼티: nickname, profile_image, thumbnail_image

AS-IS
서비스 연결 시점의 카카오계정 프로필 정보를 복사하여 기본값으로 제공
사용자 정보 저장하기 API를 사용해 서비스의 프로필 데이터로 갱신 가능

TO-BE
항상 실시간 카카오계정 프로필 정보 제공, API를 통한 갱신 불가

영향 범위

  • 다음 API를 통해 사용자 프로퍼티의 nickname, profile_image, thumbnail_image를 사용하는 서비스

  1. 사용자 정보 저장하기 API

    • nickname, profile_image, thumbnail_image 값 업데이트 요청 불가
    • 해당 키 값 업데이트 요청 시 에러가 발생하지는 않으나, 값 변경 사항은 반영되지 않음

  2. 연결하기 API

    • 연결하기 요청 시, nickname, profile_image, thumbnail_image 파라미터를 통한 값 저장 불가

  3. 사용자 정보 가져오기 API

    • 기존에 서비스에서 업데이트하여 사용했던 properties.nickname, properties.profile_image, properties.thumbnail_image 값이 아닌 카카오계정 실시간 프로필 값 반환

필요한 조치

  • 서비스 자체 프로필 또는 카카오계정 프로필로 사용자 프로퍼티 프로필을 대체합니다.
  • 기존 사용자 프로퍼티 프로필 및 기능 유지가 필요한 경우, devtalk으로 문의하시기 바랍니다.

참고

  • 카카오에서 제공하는 프로필은 세 가지로, 이 공지는 다음 중 3번 사용자 프로퍼티 프로필에 대한 내용입니다.
    1. 카카오계정 프로필: 카카오계정의 프로필, 사용자 정보 가져오기 API 응답 중 kakao_account.profile
    2. 카카오톡 프로필: 카카오톡 프로필, 카카오톡 프로필 가져오기 API 응답
    3. 사용자 프로퍼티 프로필: 사용자 프로퍼티 중 프로필을 위한 기본 프로퍼티, 서비스 프로필로 업데이트 가능, 사용자 정보 가져오기 응답 중 properties.nickname, properties.profile_image, properties.thumbnail_image
  • 사용자 프로퍼티 프로필에 카카오계정 프로필을 제공하는 것은 하위 호환을 위한 조치로,
    추후 사용자 프로퍼티의 기본 제공 프로퍼티인 profile_image, thumbnail_image, nickname는 삭제될 예정입니다. 사용자 정보 가져오기 API 응답의 kakao_account 하위의 profile 정보를 이용해주세요.

개발 가이드

| API | REST API | JavaScript SDK | Android SDK | iOS SDK | Flutter SDK |
| — | — | — | — | — | — | — |
| 사용자 정보 저장하기 | /v1/user/update_profile | Kakao.API.request({url: ‘/v1/user/update_profile’}) | updateProfile() | updateProfile() | updateProfile() |
| 연결하기 | /v1/user/signup | - | signup() | signup() | signup() |
| 사용자 정보 가져오기 | /v2/user/me | Kakao.API.request({url: ‘/v2/user/me’}) | me() | me() | me() |

언제나 더 좋은 서비스를 제공할 수 있도록 노력하겠습니다.
감사합니다.


Hello. It is Kakao.

We have an announcement on the change of user properties associated with user profile.

User property refers to a function to store some of service information in the Kakao platform. We have been providing the user properties for users nicknames, profile image URLs, and thumbnail image URLs by default. From May 12, 2022, we change a way of updating the user properties, so please check the changes described below and take action.

Effective date

  • Thursday, May 12, 2022

Changes

  • A way to update or change the user following properties that are provided by default:
    • nickname, profile_image, thumbnail_image

- Before change

  • Copy the user’s Kakao Account profile information at the moment when a user is linked with or logs into a service and provide it as a default.
  • Allow updating user profile in a service through the Storing user information API.

- After change

  • Provide user’s Kakao Account profile in real-time.
  • Not allowed to update the profile through the Storing user information API.

Target

  • Services that update the user property keys through the following APIs:
    • Target user property keys: nickname, profile_image, thumbnail_image
  1. Storing user information API
    • Cannot request to update the value of the nickname, profile_image, thumbnail_image property keys.
    • The request to update the values for the keys does not cause an error but does not make any change.
  2. Manual signup API
    • Cannot store the values through the nickname, profile_image, thumbnail_image parameters when requesting to sign up manually.
  3. Retrieving user information API
    • Return the real-time Kakao Account profile instead of properties.nickname, properties.profile_image, properties.thumbnail_image that used to be updated in a service.

What to do

  • Replace the user property profile with the profile saved on your own service or user’s Kakao Account profile.
  • If your service needs to keep using the user properties related to profiles, contact us via DevTalk.

Reference

  • Kakao provides three types of profiles, and this notice is associated with 3. User property profile.
    1. Kakao Account profile: Profile saved in Kakao Account that is returned through kakao_account.profile in response to the Retrieving user information API.
    2. Kakao Talk profile: Kakao Talk profile that is returned in response to the Retrieving Kakao Talk profile API.
    3. User property profile: Profile provided by the default user property keys, and returned through properties.nickname, properties.profile_image, properties.thumbnail_image in response to the Retrieving user information API. Available to update with the service profile.
  • We provide Kakao Account profile to be compatible with the user property profile. Since profile_image, thumbnail_image, nickname will be deleted, use the profile information under kakao_account that is passed in the response of Retrieving user information API.

Development guide

| API | REST API | JavaScript SDK | Android SDK | iOS SDK | Flutter SDK |
| — | — | — | — | — | — | — |
| Storing user information API | /v1/user/update_profile | Kakao.API.request({url: ‘/v1/user/update_profile’}) | updateProfile() | updateProfile() | updateProfile() |
| Manual signup | /v1/user/signup | - | signup() | signup() | signup() |
| Retrieving user information | /v2/user/me | Kakao.API.request({url: ‘/v2/user/me’}) | me() | me() | me() |


If you have any questions, contact us via DevTalk.

We will always do our best to provide you with better service. Thank you.


Kakao Developers