사이드바에서 선택한 Excel 행 보강하기
GenderAPI Excel 부가기능을 사용하면 이름, 이메일 주소 또는 사용자 이름 열을 선택하고 결과를 매핑된 워크시트 열에 기록할 수 있습니다. 통제된 행 범위를 처리할 때는 사이드바를, 셀 단위 계산에는 별도의 GENDER.FROM_* 함수를 사용하세요.
기본 제공 Excel 클라이언트는 레거시 API의 필드를 사용합니다. 직접 호출하는 REST V2 API의 data 및 meta 객체는 반환하지 않으므로, 통합 문서의 기존 매핑을 부가기능의 실제 출력에 맞게 유지하세요.
작은 행 범위로 먼저 설정하기
- Microsoft 공식 등록 정보에서 GenderAPI를 설치하고 통합 문서에서 부가기능의 사이드바를 여세요. 문서 접근 권한과 조직의 제한 사항이 있는지 확인하세요.
- 부가기능에 GenderAPI 키를 저장하고, 사용하려는 계정에 크레딧이 있는지 확인하세요.
- name, email 또는 username 방식과 이에 맞는 원본 열을 선택하세요. 헤더 행을 제외하고 시작 행과 끝 행으로 작은 범위를 지정하세요.
- 성별 대상 열과 선택 사항인 probability, 국가, 찾은 이름 열을 매핑하세요. 각 결과는 원본 데이터와 분리해 두세요.
- 처리하는 데이터에 대해 신뢰할 수 있을 때만 국가 컨텍스트를 지정하세요. 선택한 설정을 확인한 뒤 테스트 표본을 실행하세요.
- 범위를 넓히기 전에 identified 행, 판정되지 않은 행, 실패한 행을 검토하세요. 통합 문서의 원본 데이터 사본을 보관하세요.
입력, 컨텍스트, 결과 열 선택하기
| 설정 | 유형 | 설명 |
|---|---|---|
| API 키 | 계정 인증 정보 | 부가기능의 키 입력란으로 저장합니다. 통합 문서의 일반 셀에 입력하지 마세요. |
| 방식과 원본 | 선택 항목과 열 | name, email 또는 username과 이에 맞는 원본 열의 조합입니다. |
| 행 범위 | 행 번호 | 헤더 행을 제외한 작은 범위로 시작하세요. |
| 국가 필터 | 선택 사항인 국가 또는 열 | 알려진 국가 컨텍스트를 제공합니다. 개인의 확인된 위치를 요청하는 것이 아닙니다. |
| 결과 열 | 열 참조 | 성별 대상 열과 선택 사항인 probability, 국가, 찾은 이름 대상 열입니다. |
부가기능 결과 열 읽기
원래 입력값을 결과 옆에 보관하세요. 이름에 기반한 연관성은 본인이 밝힌 성별을 확정하지 않으며, 반환된 국가는 확인된 거주지나 국적이 아닙니다.
- 전체 데이터셋을 처리하기 전에 일반적인 결과, 모호한 입력, 실패한 작업을 각각 확인하세요.
- 빈 셀, null이라는 텍스트, 수식 오류는 스프레드시트에서 서로 다른 값입니다. 오류를 숨기지 않도록 unknown 결과를 의도적으로 정규화하세요.
- 알 수 없거나 불확실한 레코드에는 중립적인 대체 처리를 사용하세요. 본인이 제공한 프로필 정보는 추정된 열과 구분해 보관하세요.
| 결과 | 일반적인 유형 | 사용 방법 |
|---|---|---|
| Gender | 텍스트 또는 미확정 값 | 성공한 결과에서만 male 또는 female을 유지하세요. 미확정 값은 unknown으로 보존하고, 오류 텍스트는 따로 검토하세요. |
| Probability | 숫자(제공되는 경우) | 이전 방식의 신뢰도 신호입니다. V2의 confidence 필드도 아니고, 사용자의 데이터셋에서 측정한 정확도도 아닙니다. |
| Country | 텍스트(제공되는 경우) | 조회 결과로 반환된 컨텍스트입니다. 고객의 확인된 국가와 구분해 보관하세요. |
| Found / normalized name | 텍스트(제공되는 경우) | 처리 중에 사용되었거나 추출된 이름입니다. 모호한 이메일 주소와 사용자 이름에서는 이 값을 검토하세요. |
크레딧, 한도, 반복 실행 계획하기
등록된 무료 GenderAPI 계정에는 하루 200크레딧이 포함됩니다. 크레딧은 계정 잔액이며, 모든 워크플로에서 200개의 성공한 결과를 보장한다는 뜻이 아닙니다. 시작하기 전에 선택한 키의 잔액과 도구의 현재 처리 옵션을 확인하세요.
내장 부가기능과 파일 작업에는 각각 고유한 처리 경로가 있습니다. REST API V2의 일괄 요청 한도, AI 옵션, 요청별 과금 필드가 이들에 자동으로 적용되지는 않습니다. 다시 실행하거나 재계산하면 새 작업이 제출될 수 있으므로 무료라고 가정하지 마세요.
작은 표본으로 시작하고, 완료된 결과를 보관하고, 다시 실행하기 전에 실패한 행을 검토하세요. 나중에 내보내기나 대상 앱 업데이트만 바로잡으면 되는 경우에는 이미 얻은 결과를 재사용하세요.
공유할 데이터 선택하기
스프레드시트 연동은 조회에 필요한 값을 전송하며, 선택한 문서에서 작업하려면 권한이 필요합니다. 개인 데이터를 처리하기 전에 스프레드시트 파일, 연결된 계정, 결과 열에 대한 접근 권한을 검토하세요.
API 키는 일반 셀, 스크린샷, 공유 예시가 아니라 부가기능 설정에 보관하세요. 공개된 개인정보 처리방침에는 입력값 처리, 보존, 로그에 관한 내용이 설명되어 있습니다. 스프레드시트 연동이라고 해서 데이터가 전적으로 사용자의 기기 안에만 머무는 것은 아닙니다.
API V2를 직접 사용해야 하는 경우
애플리케이션에 명시적인 AI 옵션과 V2의 항목별 status, source, confidence_kind, usage 정보가 필요하다면 별도의 HTTP 연동을 사용하세요. V2의 요청 및 응답 규격을 따르세요. 내장 수식이나 기존 부가기능에 V2 필드 이름을 추가해도 해당 클라이언트의 동작은 바뀌지 않습니다.
자주 묻는 질문
Excel에서 이메일 주소와 사용자 이름도 분석할 수 있나요?
네. 사이드바에서 해당 방식을 선택하고 이에 맞는 입력 열을 매핑하세요. 결과를 사용하기 전에 반환된 이름과 판정되지 않은 결과를 확인하세요.
사이드바와 수식 중 무엇을 사용해야 하나요?
선택한 범위를 처리하고 매핑된 열에 값을 기록하려면 사이드바를 사용하세요. 셀 입력에 연결된 계산이 필요하고 재계산 동작을 이해하고 있다면 GENDER.FROM_* 수식을 선택하세요.
functions_v2.js라는 파일 이름은 부가기능이 REST V2를 사용한다는 뜻인가요?
아니요. 이는 Excel 클라이언트에 포함된 파일의 이름입니다. 이 가이드에서 검토한 공개 수식 파일은 레거시 API 엔드포인트를 호출하고 해당 API의 응답 필드를 읽습니다.
추정 결과는 확인된 고객 속성인가요?
아니요. 추정 결과는 고객이 직접 제공한 정보와 분리해 두고, 알 수 없거나 불확실한 레코드에는 중립적인 대체값을 사용하세요.
출처와 문서
이 가이드는 에 마지막으로 검토했습니다. 설치 방법은 각 플랫폼의 문서에서 확인하고, 별도의 V2 연동을 만들 때는 아래 API 문서를 사용하세요.