프로필 동의 항목 변경 신청 / Request to change scope for Profile

General / 일반
#1

신청 양식

앱에서 사용할 프로필 동의 항목을 '프로필(닉네임/프로필 사진)'에서 ‘닉네임’, '프로필 사진’으로 변경하기 위한 요청 양식입니다. (공지사항 참고)

  • 아래 주의사항과 개발 가이드를 모두 확인하셨나요?

  • 변경 대상 앱 ID: 예) 123456

  • 필요한 프로필 동의 항목: 예) 닉네임

  • 동의 항목 변경에 따른 서비스 업데이트 완료 여부: 예) 완료

주의사항

  • 기존 프로필 동의 항목인 '프로필(닉네임/프로필 사진)'은 기존에 사용 중이던 앱에서만 사용 가능하고, 2021년 6월 25일 이후 생성된 신규 앱에서는 사용할 수 없습니다. (Deprecated)
  • 한 번 분리된 동의 항목을 사용하도록 앱 설정을 변경하면 기존 동의 항목을 다시 사용할 수 없습니다. 앱 설정 복구 또한 불가능합니다.
  • 동의 항목 설정이 변경될 경우, 응답 구성이 변경되어 에러가 발생할 수 있습니다. 앱 설정을 변경하기 전, 동의 항목 변경에 따른 API 응답 변경 사항을 확인하여 서비스 업데이트를 해야 합니다. 아래 응답 구성 예시 및 개발 가이드를 참고합니다.

프로필 동의 항목 설정에 따른 응답 구성 예시

// 사용자 정보 가져오기 응답 중 프로필의 변경 예시
// 사용자가 앱에 설정된 각 동의 항목에 동의한 경우

// 1. 프로필(닉네임/프로필 사진) 동의 항목 사용 시
{
    "id":123456789,
    "kakao_account": { 
        "profile_needs_agreement": false,
        "profile": {
            "nickname": "Tim",
            "profile_image_url": "http://.../img_640x640.jpg",
            "thumbnail_image_url": "http://.../img_110x110.jpg",
            "is_default_image":false
        }, 
        ... 
    },
    ...
}

// 2. 닉네임 동의 항목만 사용 시
{
    "id":123456789,
    "kakao_account": { 
        "profile_nickname_needs_agreement": false,
        "profile": {
            "nickname": "Tim"
        },
        ...
    },
    ...
}

// 3. 프로필 사진 동의 항목만 사용 시
{
    "id":123456789,
    "kakao_account": { 
        "profile_image_needs_agreement" : false,
        "profile": {
            "profile_image_url": "http://.../img_640x640.jpg",
            "thumbnail_image_url": "http://.../img_110x110.jpg",
            "is_default_image" : false
        },
        ...
    },
    ....
}

// 4. 닉네임, 프로필 사진 동의 항목 사용 시
{
    "id":123456789,
    "kakao_account": { 
        "profile_nickname_needs_agreement": false,
        "profile_image_needs_agreement" : false,
        "profile": {
            "nickname": "Tim",
            "profile_image_url": "http://.../img_640x640.jpg",
            "thumbnail_image_url": "http://.../img_110x110.jpg",
            "is_default_image" : false
        },
        ...
    },
    ...
}

개발 가이드

=====

Request form

This request form is used to change the consent item for profile information from ‘Profile Info(nickname/profile image)’ to ‘Nickname’ and ‘Profile image’. Refer to Notice.

  • Did you read CAUTION and Reference?:

  • Target App ID: Example) 123456

  • Required scope(s) for profile information: Example) Nickname

  • Has the service updated been completed for the change of scopes? : Example) Yes / No

CAUTION

  • The ‘Profile Info(nickname/profile image)’ scope is still available but only for the existing apps. It cannot be used in the apps created after June 25, 2021. (Deprecated)
  • If you change your app settings to use the ‘Nickname’ or/and ‘Profile image’ scopes, you cannot use the previous scope anymore and cannot undo the change of the app settings.
  • If the consent item setting is changed, an error may occur due to the changes of API response. Thus, you must update the source code for the change in the API response before applying the separated version of scopes to your app. Refer to the response examples and documentation below for more details.

Response examples by enabled scope

// Response examples of the Retrieving user information API depending on enabled scopes
// If a user agreed to the following scope set in the app

// 1. If you enable 'Profile Info(nickname/profile image)'
{
    "id":123456789,
    "kakao_account": { 
        "profile_needs_agreement": false,
        "profile": {
            "nickname": "Tim",
            "profile_image_url": "http://.../img_640x640.jpg",
            "thumbnail_image_url": "http://.../img_110x110.jpg",
            "is_default_image":false
        },
        ...
    },
    ...
}

// 2. If you enable 'Nickname' only
{
    "id":123456789,
    "kakao_account": { 
        "profile_nickname_needs_agreement": false,
        "profile": {
            "nickname": "Tim"
        }, 
        ... 
    },
    ...
}

// 3. If you enable 'Profile image' only
{
    "id":123456789,
    "kakao_account": { 
        "profile_image_needs_agreement" : false,
        "profile": {
            "profile_image_url": "http://.../img_640x640.jpg",
            "thumbnail_image_url": "http://.../img_110x110.jpg",
            "is_default_image" : false
        }, 
        ... 
    },
    ...
}

// 4. If you enable both 'Nickname 'and 'Profile image'
{
    "id":123456789,
    "kakao_account": { 
        "profile_nickname_needs_agreement": false,
        "profile_image_needs_agreement" : false,
        "profile": {
            "nickname": "Tim",
            "profile_image_url": "http://.../img_640x640.jpg",
            "thumbnail_image_url": "http://.../img_110x110.jpg",
            "is_default_image" : false
        }, 
        ... 
    },
    ....
}

Reference

닉네임/프로필 사진 동의 항목 분리 및 API 응답 변경사항 안내 / [Change Notice] Separation of consent items (nickname/profile image) and API response
프로필 동의 항목 변경 신청 글로 남기면 되나요?
카카오 간편 회원가입 시 api 변경 문의