Bổ sung dữ liệu cho các hàng Excel từ thanh bên
Phần bổ trợ GenderAPI cho Excel cho phép bạn chọn một cột tên, địa chỉ email hoặc tên người dùng và ghi kết quả vào các cột đã ánh xạ trên trang tính. Hãy dùng thanh bên để xử lý một phạm vi hàng có kiểm soát, hoặc dùng các hàm GENDER.FROM_* cho các phép tính gắn với ô.
Máy khách gốc của Excel sử dụng các trường của API cũ. Nó không trả về các đối tượng data và meta của REST V2; hãy giữ các ánh xạ hiện có trong sổ làm việc khớp với đầu ra thực tế của phần bổ trợ.
Thiết lập với một phạm vi hàng nhỏ trước
- Cài đặt GenderAPI từ trang niêm yết chính thức trong danh mục của Microsoft và mở thanh bên của phần bổ trợ trong sổ làm việc. Hãy kiểm tra quyền truy cập tài liệu và mọi hạn chế của tổ chức bạn.
- Lưu khóa GenderAPI của bạn trong phần bổ trợ và xác nhận rằng tài khoản đã chọn còn tín dụng.
- Chọn phương thức name, email hoặc username cùng cột nguồn tương ứng. Đặt một phạm vi hàng nhỏ, không bao gồm hàng tiêu đề.
- Ánh xạ cột đích cho giới tính và, nếu cần, các cột probability, quốc gia và tên tìm thấy. Giữ từng kết quả tách biệt với dữ liệu nguồn.
- Chỉ đặt ngữ cảnh quốc gia khi thông tin đó đáng tin cậy đối với dữ liệu bạn đang xử lý. Kiểm tra các thiết lập đã chọn rồi chạy mẫu.
- Kiểm tra các hàng identified, chưa xác định được và thất bại trước khi mở rộng phạm vi. Hãy giữ một bản sao dữ liệu gốc của sổ làm việc.
Chọn đầu vào, ngữ cảnh và các cột kết quả
| Thiết lập | Loại | Mô tả |
|---|---|---|
| Khóa API | Thông tin xác thực của tài khoản | Được lưu qua trường nhập khóa của phần bổ trợ; không nhập khóa vào các ô thông thường của sổ làm việc. |
| Phương thức và nguồn | Lựa chọn và cột | name, email hoặc username cùng với cột nguồn tương ứng. |
| Phạm vi hàng | Số hàng | Bắt đầu với một phạm vi nhỏ, không bao gồm hàng tiêu đề. |
| Bộ lọc quốc gia | Quốc gia hoặc cột tùy chọn | Cung cấp ngữ cảnh quốc gia đã biết; trường này không xác nhận vị trí đã được xác minh của người đó. |
| Các cột kết quả | Tham chiếu cột | Một cột đích cho giới tính và các cột đích tùy chọn cho probability, quốc gia và tên tìm thấy. |
Đọc các cột kết quả
Giữ giá trị gốc bên cạnh kết quả. Một mối liên hệ dựa trên tên không xác lập giới tính do chính người đó tự công bố, và quốc gia được trả về không chứng minh nơi cư trú hay quốc tịch.
- Kiểm tra một kết quả thông thường, một đầu vào không rõ ràng và một lần chạy thất bại trước khi xử lý toàn bộ tập dữ liệu.
- Ô trống, văn bản null và lỗi công thức là các giá trị khác nhau. Hãy chuẩn hóa kết quả không xác định một cách có chủ đích mà không che giấu lỗi.
- Dùng cách diễn đạt trung lập cho các trường hợp không xác định hoặc không chắc chắn, và giữ thông tin do chính người đó cung cấp tách biệt với các ước tính.
| Kết quả | Loại | Cách dùng |
|---|---|---|
| Gender | Văn bản hoặc giá trị chưa xác định được | Chỉ lưu male hoặc female khi kết quả thành công. Lưu giá trị chưa xác định được là unknown và xem xét riêng các thông báo lỗi. |
| Probability | Số, khi có | Một chỉ báo độ tin cậy kế thừa từ trước. Giá trị này không tương đương với trường confidence của V2 và cũng không phải độ chính xác được đo trên dữ liệu của bạn. |
| Country | Văn bản, khi có | Ngữ cảnh do phép tra cứu trả về. Giữ tách biệt với quốc gia đã được xác minh của khách hàng. |
| Found / normalized name | Văn bản, khi có | Tên được dùng hoặc được trích xuất trong quá trình xử lý. Hãy xem lại giá trị này khi địa chỉ email hoặc tên người dùng không rõ ràng. |
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ó.
Chọn dữ liệu bạn chia sẻ
Các tích hợp bảng tính gửi những giá trị cần thiết cho việc tra cứu và yêu cầu quyền đối với tài liệu đã chọn. Trước khi xử lý dữ liệu cá nhân, hãy xem lại ai có quyền truy cập bảng tính, tài khoản nào được kết nối và các cột đích nào được sử dụng.
Lưu khóa API trong phần cài đặt của tiện ích bổ sung, không phải trong các ô thông thường, ảnh chụp màn hình hoặc ví dụ được chia sẻ. Chính sách quyền riêng tư đã công bố mô tả cách dữ liệu đầu vào được xử lý, lưu giữ và ghi nhật ký. Việc dùng tích hợp bảng tính không có nghĩa là dữ liệu chỉ nằm trên thiết bị của bạn.
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ể phân tích địa chỉ email và tên người dùng trong Excel không?
Có. Hãy chọn phương thức tương ứng trong thanh bên và ánh xạ đúng cột đầu vào. Kiểm tra tên được trả về và các trường hợp chưa xác định được trước khi sử dụng kết quả.
Tôi nên dùng thanh bên hay công thức?
Hãy dùng thanh bên để xử lý một phạm vi đã chọn và ghi giá trị vào các cột đã ánh xạ. Hãy chọn các công thức GENDER.FROM_* khi bạn cần các phép tính gắn với ô và lưu ý đến tác động của việc tính toán lại.
Tên tệp functions_v2.js có nghĩa là phần bổ trợ sử dụng REST V2 không?
Không. Đó chỉ là tên một tệp của máy khách Excel. Tệp công thức công khai được xem xét cho hướng dẫn này gọi các endpoint của API cũ và đọc các trường phản hồi của chúng.
Kết quả ước tính có phải là thuộc tính đã được xác minh của khách hàng không?
Không. Hãy giữ chúng tách biệt với thông tin do chính khách hàng cung cấp và dùng một phương án trung lập cho các kết quả không xác định hoặc các trường hợp không chắc chắn.
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 . 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.