# Google Sheets의 새 행을 위한 GenderAPI 워크플로 설정하기

> Google Sheets의 내장 워크플로를 구성하고, 입력 열과 결과 열을 매핑하고, 새 행이 실제로 들어오는 경로를 테스트하고, 누락된 업데이트와 unknown 결과를 처리하세요.

Canonical HTML: https://www.genderapi.io/ko/blog/how-to-find-gender-of-customers-in-google-sheets-in-real-time

Last reviewed: 2026-09-30

## 들어오는 레코드를 결과 열에 매핑하기

GenderAPI 부가기능에는 스프레드시트의 새 레코드를 성별 열과 선택적 결과 열에 매핑하는 워크플로 화면이 있습니다. 대상 시트에 맞게 설정한 다음, 자동화에 의존하기 전에 실제로 들어온 레코드를 확인하세요.

내장 워크플로는 V2의 직접 HTTP 작업과 별개입니다. 트리거 동작, 실행 시점, 결과 필드는 설치된 부가기능과 Google 계정에 따라 달라집니다. 새 행이 들어오는 모든 경로에서 즉시 업데이트된다는 보장은 없습니다.

## 워크플로 만들고 테스트하기

- GenderAPI 부가기능을 설치해 연 다음 사이드바 메뉴에서 Workflows를 여세요.
- 시트와 API 키를 선택하세요. 원본 열에 맞춰 name, email 또는 username 분석을 선택하세요.
- 원본 열 하나와 성별을 기록할 별도의 대상 열을 매핑하세요. probability, 국가, 찾은 이름의 대상 열은 필요할 때만 추가하세요.
- 워크플로를 만들기 전에 모든 매핑을 검토하세요. 인터페이스는 열 충돌을 막아 주며, 이미 워크플로가 있거나 워크플로 한도에 도달했다고 표시할 수 있습니다.
- 운영 데이터가 들어오는 것과 같은 방식으로 대표적인 레코드를 추가하세요. 값이 올바른 행에 표시되고 기존 필드를 덮어쓰지 않는지 확인하세요.
- 미확정 값과 운영 오류를 테스트한 다음, 누락되거나 실패한 행을 어떻게 발견하고 검토할지 정하세요.

- [Google Sheets 부가기능 설치하기](https://workspace.google.com/marketplace/app/gender_api_for_google_sheets_determines/712811575775)

## 내장 워크플로 필드 구성하기

| 설정 | 유형 | 용도 |
| --- | --- | --- |
| API 키 | 인증 정보 | 의도한 계정을 선택하고 사용 가능한 크레딧을 확인하세요. |
| 시트 | 시트 선택 | 이 워크플로가 처리할 레코드가 있는 시트입니다. |
| 방식 | 선택 항목 | name, email 또는 username 중 하나입니다. 선택한 방식에 따라 입력값을 해석하는 방법이 정해집니다. |
| 원본 열 | 열 참조 | 각 레코드에서 분석할 값입니다. |
| 성별 열 | 열 참조 | 입력 열 및 다른 결과 열과 구분되는 대상 열입니다. |
| Probability, 국가, 찾은 이름 | 선택적 대상 열 | 부가기능의 추가 결과를 위한 별도의 열입니다. |

## 행이 실제로 들어오는 방식 테스트하기

값을 직접 입력하는 것, 양식을 제출하는 것, CRM을 통해 레코드를 가져오는 것은 서로 다른 이벤트입니다. Google의 트리거 문서에 따르면 스크립트 실행과 API 요청은 일반적으로 설치형 트리거를 실행하지 않습니다. 공개 등록 정보만으로는 부가기능이 트리거를 정확히 어떻게 구현하는지 알 수 없으므로, 사용할 경로를 직접 테스트하세요.

워크플로가 기존 행을 소급해 처리했다고 가정하지 마세요. 기존 행을 처리하려면 일괄 처리용 사이드바로 의도적인 작업을 실행하고, 이미 처리한 행을 기록해 두세요.

예상한 업데이트가 없다면 같은 레코드를 다시 제출하기 전에 워크플로, 권한, 키의 잔액, 결과 매핑, 플랫폼 오류를 확인하세요.

- [Google 설치형 트리거의 제한 사항](https://developers.google.com/apps-script/guides/triggers/installable)
- [기존 행 일괄 처리](https://www.genderapi.io/ko/blog/how-to-determine-gender-in-google-sheets-using-gender-api-add-on)

## 부가기능 결과 열 읽기

원래 입력값을 결과 옆에 보관하세요. 이름에 기반한 연관성은 본인이 밝힌 성별을 확정하지 않으며, 반환된 국가는 확인된 거주지나 국적이 아닙니다.

- 전체 데이터셋을 처리하기 전에 일반적인 결과, 모호한 입력, 실패한 작업을 각각 확인하세요.
- 빈 셀, null이라는 텍스트, 수식 오류는 스프레드시트에서 서로 다른 값입니다. 오류를 숨기지 않도록 unknown 결과를 의도적으로 정규화하세요.
- 알 수 없거나 불확실한 레코드에는 중립적인 대체 처리를 사용하세요. 본인이 제공한 프로필 정보는 추정된 열과 구분해 보관하세요.

| 결과 | 일반적인 유형 | 사용 방법 |
| --- | --- | --- |
| Gender | 텍스트 또는 미확정 값 | 성공한 결과에서만 male 또는 female을 유지하세요. 미확정 값은 unknown으로 보존하고, 오류 텍스트는 따로 검토하세요. |
| Probability | 숫자(제공되는 경우) | 이전 방식의 신뢰도 신호입니다. V2의 confidence 필드도 아니고, 사용자의 데이터셋에서 측정한 정확도도 아닙니다. |
| Country | 텍스트(제공되는 경우) | 조회 결과로 반환된 컨텍스트입니다. 고객의 확인된 국가와 구분해 보관하세요. |
| Found / normalized name | 텍스트(제공되는 경우) | 처리 중에 사용되었거나 추출된 이름입니다. 모호한 이메일 주소와 사용자 이름에서는 이 값을 검토하세요. |

- [신뢰도와 한계를 해석하는 방법](https://www.genderapi.io/ko/accuracy-methodology)

## 크레딧, 한도, 반복 실행 계획하기

등록된 무료 GenderAPI 계정에는 하루 200크레딧이 포함됩니다. 크레딧은 계정 잔액이며, 모든 워크플로에서 200개의 성공한 결과를 보장한다는 뜻이 아닙니다. 시작하기 전에 선택한 키의 잔액과 도구의 현재 처리 옵션을 확인하세요.

내장 부가기능과 파일 작업에는 각각 고유한 처리 경로가 있습니다. REST API V2의 일괄 요청 한도, AI 옵션, 요청별 과금 필드가 이들에 자동으로 적용되지는 않습니다. 다시 실행하거나 재계산하면 새 작업이 제출될 수 있으므로 무료라고 가정하지 마세요.

작은 표본으로 시작하고, 완료된 결과를 보관하고, 다시 실행하기 전에 실패한 행을 검토하세요. 나중에 내보내기나 대상 앱 업데이트만 바로잡으면 되는 경우에는 이미 얻은 결과를 재사용하세요.

- [계정 요금제와 크레딧](https://www.genderapi.io/ko/price)

## API V2를 직접 사용해야 하는 경우

애플리케이션에 명시적인 AI 옵션과 V2의 항목별 status, source, confidence_kind, usage 정보가 필요하다면 별도의 HTTP 연동을 사용하세요. V2의 요청 및 응답 규격을 따르세요. 내장 수식이나 기존 부가기능에 V2 필드 이름을 추가해도 해당 클라이언트의 동작은 바뀌지 않습니다.

- [Make의 V2 HTTP 워크플로](https://www.genderapi.io/ko/blog/make-gender-api-integration)
- [Zapier의 V2 HTTP 워크플로](https://www.genderapi.io/ko/blog/zapier-gender-api-integration)
- [V2 요청 매개변수](https://www.genderapi.io/ko/docs/v2/request-parameters)

## CRM에서 가져올 때마다 내장 워크플로가 트리거되나요?

그렇게 가정하지 마세요. 실제 CRM이나 자동화에서 레코드를 하나 보내 테스트하세요. Google은 사용자의 편집, 제출된 양식, API 기반 업데이트를 구분하며, 설치된 부가기능의 트리거 동작은 직접 확인해야 합니다.

## 시트에 이미 있던 행도 처리할 수 있나요?

의도적으로 선택한 행 범위로 일괄 처리용 사이드바를 사용하세요. 새 행을 위한 워크플로를 만든다고 해서 기존 레코드가 소급 처리되지는 않습니다.

## 워크플로는 몇 개까지 만들 수 있나요?

인터페이스에 워크플로 한도가 표시될 수 있지만, 이 가이드에서는 확인되지 않은 숫자를 제시하지 않습니다. 현재 부가기능을 확인하고, 필요하면 더 이상 쓰지 않는 워크플로를 삭제하세요.

## V2의 source와 usage 필드는 어떻게 얻을 수 있나요?

별도의 V2 HTTP 연동을 만드세요. 예를 들어 문서화된 Make 또는 Zapier 가이드를 따를 수 있습니다. 내장 결과 열에 V2 응답 구조가 들어 있다고 가정하지 마세요.

## 출처와 문서

- [Google Sheets 부가기능 공식 페이지](https://workspace.google.com/marketplace/app/gender_api_for_google_sheets_determines/712811575775)
- [Google Apps Script 설치형 트리거](https://developers.google.com/apps-script/guides/triggers/installable)
- [Google Apps Script 할당량과 한도](https://developers.google.com/apps-script/guides/services/quotas)
- [GenderAPI 요금제와 크레딧](https://www.genderapi.io/ko/price)
- [GenderAPI 개인정보 처리방침](https://www.genderapi.io/ko/privacy-policy)
- [V2 요청 규격](https://www.genderapi.io/ko/docs/v2/request-parameters)