Công thức GenderAPI cho Microsoft Excel

Chọn hàm phù hợp với dữ liệu đầu vào

Hãy cài đặt phần bổ trợ GenderAPI cho Excel, lưu khóa API của bạn trong thanh bên của nó và dùng GENDER.FROM_NAME cho tên, GENDER.FROM_EMAIL cho địa chỉ email hoặc GENDER.FROM_USERNAME cho tên người dùng. Mỗi hàm nhận đầu vào trước, tiếp theo là một cờ tùy chọn để bật thông tin bổ sung và cuối cùng là ngữ cảnh quốc gia tùy chọn.

Các công thức gốc của Excel này dựa trên API cũ. Công thức GENDER của Google Sheets có cấu trúc đối số khác, và REST V2 API gọi trực tiếp có đặc tả JSON riêng.

Ba đối số theo thứ tự cố định

Đối số	Loại	Giá trị mặc định	Mô tả
`name / email / username`	Văn bản hoặc tham chiếu ô	Bắt buộc	Đầu vào cho hàm đã chọn, ví dụ A2.
`enable_additional_info`	Boolean	FALSE	Dùng TRUE hoặc 1 để trả về 4 cột. Bỏ qua đối số này hoặc dùng FALSE/0 để chỉ nhận giới tính.
`country`	Văn bản	Không có bộ lọc quốc gia	Mã quốc gia 2 chữ cái tùy chọn, ví dụ IT, US, DE hoặc TR. Khi cung cấp đối số thứ 3 này, hãy chỉ định cả đối số thứ 2.

Mỗi dòng là một ví dụ riêng. Nhập tên, địa chỉ email hoặc tên người dùng tương ứng vào A2. Tùy theo cài đặt khu vực của Excel, bạn có thể cần dùng dấu chấm phẩy thay cho dấu phẩy để phân tách các đối số.

=GENDER.FROM_NAME(A2)
=GENDER.FROM_NAME(A2, TRUE, "IT")
=GENDER.FROM_EMAIL(A2, TRUE)
=GENDER.FROM_USERNAME(A2, FALSE)

Đầu ra mở rộng của Excel sử dụng 4 cột

Khi không bật thông tin bổ sung, công thức chỉ trả về giới tính. Khi bật, đầu ra được ghi trong tài liệu của Excel nằm trên 1 hàng gồm giới tính, probability, quốc gia và tên tìm thấy, theo đúng thứ tự đó. Hãy để trống 3 ô bên phải.

Công thức của Google Sheets đặt quốc gia trước probability, vì vậy đừng dùng lại các tiêu đề cột của nó khi chưa kiểm tra thứ tự hợp lệ trong Excel.

Vị trí	Đầu ra của Excel	Ý nghĩa
1	Gender	Giới tính đã xác định hoặc giá trị chưa xác định được. Hãy xử lý riêng các lỗi vận hành.
2	Probability	Tín hiệu độ tin cậy của API cũ; không phải confidence_kind của V2 cũng không phải độ chính xác đo được của mô hình.
3	Country	Ngữ cảnh quốc gia được trả về từ lần tra cứu, không phải thuộc tính đã được xác minh của người đó.
4	Matched name	Kiểm tra tên được sử dụng hoặc trích xuất, đặc biệt đối với địa chỉ email và tên người dùng.

Khắc phục lỗi thiết lập trước khi sao chép công thức xuống các hàng dưới

Việc tính toán lại có thể gửi một lần tra cứu mới. Khi cần một bản chụp cố định, hãy dán các kết quả đã hoàn tất dưới dạng giá trị và lưu dữ liệu gốc cùng ngày kiểm tra bên cạnh.

Triệu chứng	Cần kiểm tra
Hàm không khả dụng	Xác nhận rằng phần bổ trợ đã được cài đặt và khả dụng trong sổ làm việc này và môi trường Excel này.
Chưa thiết lập khóa API	Mở thanh bên GenderAPI và lưu khóa. Khóa được nhập vào một ô không thay thế cho thông tin xác thực đã lưu trong phần bổ trợ.
Đầu vào trống	Kiểm tra ô mà công thức tham chiếu và chọn hàm phù hợp với loại đầu vào thực tế.
Đầu ra mở rộng không hiển thị	Làm trống các ô đích liền kề cần thiết mà không ghi đè dữ liệu hữu ích.
Thông báo lỗi hoặc unknown error	Kiểm tra kết nối, trạng thái tài khoản và thông báo được trả về. Lỗi vận hành khác với một kết quả ước tính chưa xác định được.

Lên kế hoạch cho tín dụng, giới hạn và các lần chạy lại

Một tài khoản GenderAPI miễn phí đã đăng ký bao gồm 200 tín dụng mỗi ngày. Đây là số dư tài khoản, không phải lời hứa về 200 kết quả identified trong mọi quy trình làm việc. Trước khi bắt đầu, hãy kiểm tra số dư của khóa đã chọn và các tùy chọn xử lý hiện tại của công cụ.

Tiện ích bổ sung và việc xử lý tệp có luồng xử lý riêng. Giới hạn hàng loạt, các tùy chọn AI và các trường tính phí theo từng yêu cầu của REST API V2 không tự động áp dụng cho các công cụ này. Một lần chạy lại hoặc tính toán lại có thể gửi yêu cầu mới và tiêu tốn tín dụng, vì vậy đừng cho rằng việc đó là miễn phí.

Bắt đầu với một mẫu nhỏ, lưu các kết quả đã có và xem lại các hàng thất bại trước khi chạy lại. Nếu bạn chỉ cần sửa một lần xuất dữ liệu hoặc một lần cập nhật ở hệ thống đích, hãy dùng lại các kết quả hiện có.

Gói tài khoản và tín dụng

Khi nào nên dùng trực tiếp API V2

Hãy thiết lập một tích hợp HTTP riêng khi ứng dụng của bạn cần các tùy chọn AI rõ ràng cùng thông tin status, source, confidence_kind và usage của V2 cho từng mục. Hãy tuân theo đặc tả yêu cầu và phản hồi của V2. Việc thêm tên trường V2 vào công thức riêng của tiện ích bổ sung hoặc vào một tiện ích bổ sung hiện có không làm thay đổi cách hoạt động của chúng.

Câu hỏi thường gặp

Tôi có thể dùng công thức =GENDER(A2) trong Microsoft Excel không?

Các hàm được ghi trong tài liệu của phần bổ trợ Excel là GENDER.FROM_NAME, GENDER.FROM_EMAIL và GENDER.FROM_USERNAME. Công thức GENDER đơn giản thuộc về tiện ích bổ sung Google Sheets.

Làm thế nào để chỉ định quốc gia mà không có đầu ra bổ sung?

Hãy giữ đối số thứ 2 ở trạng thái tắt, ví dụ =GENDER.FROM_NAME(A2, FALSE, "IT"). Quốc gia là đối số thứ 3, không phải thứ 2.

Giá trị mặc định của thiết lập thông tin bổ sung là gì?

Khi bỏ qua đối số, thiết lập này ở trạng thái tắt. TRUE hoặc 1 bật đầu ra 4 cột: giới tính, probability, quốc gia và tên tìm thấy.

Các hàm này có trả về thông tin tính phí của V2 không?

Không. Các công thức gốc trả về các trường kết quả của API cũ. Hãy dùng một tích hợp V2 riêng khi bạn cần siêu dữ liệu của yêu cầu, source, confidence_kind hoặc mức sử dụng theo từng yêu cầu.

Nguồn và tài liệu

Hướng dẫn này được kiểm tra lần cuối vào ngày 29 tháng 9, 2026. Hãy kiểm tra cách cài đặt trong tài liệu của từng nền tảng. Để xây dựng một tích hợp V2 riêng, hãy dùng tài liệu API bên dưới.