사용자 정보에서 *_needs_agreement가 뜻하는게 뭔가요?

[haiimaindeveloper]

안녕하세요. 개발 가이드 문서를 읽어봐도 잘 이해가 안되어서 질문남깁니다.

현재 카카오톡 로그인해서 사용자 정보를 받아오면

phone_number_needs_agreement
age_range_needs_agreement
birthyear_needs_agreement
gender_needs_agreement

같은 필드들이 있는데 이값들이 가지는 의미가 뭔가요??

개발 가이드에는 "** 얻기 위해 정보 제공 동의가 필요한지에 대한 여부"라고 되어있는데

이것이 의미하는것이 뭔지 잘 이해가 안됩니다.

1. 사용자가 "카카오 로그인"을 누른후 나오는 팝업창에서 성별에 대한 제 3자 제공 동의를 안하면 gender_needs_agreement은 뭐라고 표시되나요??

2. 만약 카카오 서버측에 사용자의 gender가 저장이 안되어있으면 gender_needs_agreement은 뭐라고 나오나요?

3. 저희쪽에서 앱 설정 > 사용자 관리 > 로그인 동의항목에서 성별을 off로 나오면 gender_needs_agreement은 뭐라고 나오나요???

미리 답변 감사합니다.

[karl.lee]

카카오에서 해당 정보를 보유하지 않은 경우, 제 3자 정보제공동의에 노출되지 않으며, needs_agreement 값은 false 입니다.

성별 항목을 기준으로 예를 들면,
성별 값(male/female)이 있는데 gender_needs_agreement가 false이면 사용자가 동의를 하고 값을 취득한 것이고,
성별 값(male/female)이 없는데 gender_needs_agreement가 true이면 사용자가 동의를 하지 않아서 값을 취득하지 못한 것이고,
성별 값(male/female)이 없는데 gender_needs_agreement가 false이면 카카오에서 성별 정보를 보유하지 않은 경우입니다. (해당 경우는 제 3자 정보제공동의 창에서 성별 항목이 없습니다.)

1. 제3자 정보제공동의 창에 노출되었으나 사용자가 동의하지 않은 경우 needs_agreement 는 true 입니다.
2. 언제나 false 입니다.
3. 성별 스콥을 설정하지 않으신 경우 gender와 관련된 항목(gender_needs_agreement 등)은 내려가지 않습니다.

[haiimaindeveloper]

그렇군요 빠른 답변 감사합니다!

질문 논외지만 혹시 개발가이드 문서에 답변주신 내용을 추가하실 생각은 없나요??
저만 이해를 못하는 건 아닐거라고 생각이 들어서요…

[karl.lee]

가이드 개선 건의에 대해 감사드립니다.
사용자 정보요청 개발가이드에 needs_agreement 와 관련된 가이드 카카오계정의 이메일, 연령대, 생일, 성별을 활용하기전에 확인하세요! 가 v1 사용자 정보 요청과 달라진 점 바로 위에 있으며, 해당 가이드가 위 내용을 포함하고 있는데요. 사용자에게 보다 쉽게 파악될 수 있도록 위치와 문구에 대해 고민하겠습니다.

1) 사용자 정보 요청 API 응답에 값(kakao_account.XXX)이 있는지 확인합니다.
- kakao_account.XXX이 있다면 해당 값을 사용 (2번 진행 불필요)
- kakao_account.XXX이 없다면 아래 2번 진행

2) kakao_account.XXX_needs_agreement 값으로 동의가 필요한지를 판단합니다.
- true: 정보 제공 동의 후 값을 얻을 수 있는 상태입니다. 필요 시 동적동의를 요청하면 됩니다. 동적동의 시 전달할 scope은 설-정 > 사용자 관리 > 동의항목 에 표기되어 있습니다.
- false: 정보 제공 동의 여부와 관련 없이 값을 얻을 수 없는 상태(카카오계정에 값이 없는 경우 등)입니다. 필요 시 자체 수집 플로우를 구현하시면 됩니다.