입력에 맞는 함수 사용하기
GenderAPI Excel 부가기능을 설치하고 사이드바에 API 키를 저장한 뒤, 이름에는 GENDER.FROM_NAME, 이메일 주소에는 GENDER.FROM_EMAIL, 사용자 이름에는 GENDER.FROM_USERNAME을 사용하세요. 각 함수는 첫 번째로 입력을, 두 번째로 선택 사항인 추가 정보 플래그를, 마지막으로 선택 사항인 국가 컨텍스트를 받습니다.
이 함수들은 레거시 API를 기반으로 하는 기본 제공 Excel 수식입니다. Google Sheets는 GENDER 수식에 다른 시그니처를 사용하며, 직접 호출하는 REST V2 API에는 별도의 JSON 규격이 있습니다.
정해진 순서로 입력하는 세 가지 인수
| 인수 | 유형 | 기본값 | 설명 |
|---|---|---|---|
name / email / username | 텍스트 또는 셀 참조 | 필수 | 선택한 함수에 넣는 입력입니다(예: A2). |
enable_additional_info | 불리언 | FALSE | TRUE 또는 1을 사용하면 4개 열을 반환합니다. 성별 값만 필요하면 인수를 생략하거나 FALSE/0을 사용하세요. |
country | 텍스트 | 국가 필터 없음 | IT, US, DE, TR 같은 선택 사항인 2자리 국가 코드입니다. 이 3번째 인수를 지정할 때는 2번째 인수도 함께 지정해야 합니다. |
각 줄은 별도의 예시입니다. A2에 해당하는 이름, 이메일 주소 또는 사용자 이름을 입력하세요. Excel의 지역 설정에 따라 인수 구분 기호가 쉼표 대신 세미콜론일 수 있습니다.
=GENDER.FROM_NAME(A2)
=GENDER.FROM_NAME(A2, TRUE, "IT")
=GENDER.FROM_EMAIL(A2, TRUE)
=GENDER.FROM_USERNAME(A2, FALSE)4개 열로 표시되는 Excel 확장 출력
추가 정보를 끄면 수식은 성별 값을 반환합니다. 추가 정보를 켜면 문서화된 Excel 출력은 성별, probability, 국가, 일치한 이름을 이 순서대로 담은 1개 행입니다. 오른쪽에 있는 셀 3개를 비워 두세요.
Google Sheets 수식은 probability보다 국가를 먼저 표시하므로, Excel의 순서를 확인하지 않고 그 열 제목을 그대로 재사용하지 마세요.
| 위치 | Excel 출력 | 해석 |
|---|---|---|
| 1 | Gender | 식별된 성별 또는 판정되지 않은 값입니다. 운영 오류는 따로 구분하세요. |
| 2 | Probability | 레거시 API의 신뢰도 신호이며, V2의 confidence_kind나 측정된 모델 정확도가 아닙니다. |
| 3 | Country | 조회에서 반환된 컨텍스트이며, 확인된 개인 속성이 아닙니다. |
| 4 | Matched name | 사용되거나 추출된 이름을 확인하세요. 특히 이메일 주소와 사용자 이름에서 중요합니다. |
수식을 아래로 복사하기 전에 설정 오류 확인하기
수식을 재계산하면 새 조회가 전송될 수 있습니다. 변하지 않는 스냅샷이 필요하면 완료된 결과를 값으로 복사하고, 원본 데이터와 검토 날짜를 함께 보관하세요.
| 증상 | 확인할 사항 |
|---|---|
| 함수를 사용할 수 없음 | 부가기능이 설치되어 있고 이 통합 문서와 Excel 환경에서 사용할 수 있는지 확인하세요. |
| API 키가 설정되지 않음 | GenderAPI 사이드바를 열고 키를 저장하세요. 셀에 입력한 키는 부가기능에 저장된 인증 정보가 아닙니다. |
| 입력이 비어 있음 | 수식이 참조하는 셀을 확인하고, 실제 입력 유형에 맞는 함수를 선택하세요. |
| 확장 출력을 표시할 수 없음 | 유용한 데이터를 덮어쓰지 않도록 주의하면서 필요한 인접 대상 셀을 비우세요. |
| 오류 텍스트 또는 unknown error | 연결 상태, 계정 상태와 반환된 메시지를 확인하세요. 운영 오류를 판정되지 않은 추정 결과로 취급하지 마세요. |
크레딧, 한도, 반복 실행 계획하기
등록된 무료 GenderAPI 계정에는 하루 200크레딧이 포함됩니다. 크레딧은 계정 잔액이며, 모든 워크플로에서 200개의 성공한 결과를 보장한다는 뜻이 아닙니다. 시작하기 전에 선택한 키의 잔액과 도구의 현재 처리 옵션을 확인하세요.
내장 부가기능과 파일 작업에는 각각 고유한 처리 경로가 있습니다. REST API V2의 일괄 요청 한도, AI 옵션, 요청별 과금 필드가 이들에 자동으로 적용되지는 않습니다. 다시 실행하거나 재계산하면 새 작업이 제출될 수 있으므로 무료라고 가정하지 마세요.
작은 표본으로 시작하고, 완료된 결과를 보관하고, 다시 실행하기 전에 실패한 행을 검토하세요. 나중에 내보내기나 대상 앱 업데이트만 바로잡으면 되는 경우에는 이미 얻은 결과를 재사용하세요.
API V2를 직접 사용해야 하는 경우
애플리케이션에 명시적인 AI 옵션과 V2의 항목별 status, source, confidence_kind, usage 정보가 필요하다면 별도의 HTTP 연동을 사용하세요. V2의 요청 및 응답 규격을 따르세요. 내장 수식이나 기존 부가기능에 V2 필드 이름을 추가해도 해당 클라이언트의 동작은 바뀌지 않습니다.
자주 묻는 질문
Microsoft Excel에서 =GENDER(A2)를 사용할 수 있나요?
문서화된 Excel 부가기능 함수는 GENDER.FROM_NAME, GENDER.FROM_EMAIL, GENDER.FROM_USERNAME입니다. 단순한 GENDER 수식은 Google Sheets 부가기능의 수식입니다.
추가 출력 없이 국가를 지정하려면 어떻게 하나요?
2번째 인수를 끈 상태로 두세요. 예: =GENDER.FROM_NAME(A2, FALSE, "IT"). 국가는 2번째가 아니라 3번째 인수입니다.
추가 정보의 기본 설정은 무엇인가요?
인수를 생략하면 꺼져 있습니다. TRUE 또는 1을 지정하면 성별, probability, 국가, 일치한 이름으로 구성된 4개 열 출력이 활성화됩니다.
함수가 V2 과금 정보를 반환하나요?
아니요. 기본 제공 수식은 레거시 API의 결과 필드를 표시합니다. 요청 메타데이터, source, confidence_kind 또는 요청별 사용량이 필요하면 별도의 V2 연동을 사용하세요.
출처와 문서
이 가이드는 에 마지막으로 검토했습니다. 설치 방법은 각 플랫폼의 문서에서 확인하고, 별도의 V2 연동을 만들 때는 아래 API 문서를 사용하세요.