Dùng tiện ích mở rộng Airtable để ánh xạ các trường
Tiện ích mở rộng GenderAPI đọc tên hoặc địa chỉ email từ trường bạn chọn và ghi tín hiệu giới tính được dự đoán vào một trường đích riêng. Bạn cũng có thể ánh xạ quốc gia, probability và tên được tìm thấy, rồi bỏ qua những bản ghi mà trường đích giới tính đã có giá trị.
Mã nguồn của tiện ích mở rộng được xem xét vào ngày 27 tháng 9 năm 2026 sử dụng các endpoint V1 cũ cho tên và địa chỉ email cùng các trường phản hồi ở cấp cao nhất của chúng. Hướng dẫn này mô tả quy trình làm việc gốc đó. Tiện ích mở rộng đã cài đặt có thể thay đổi độc lập với hướng dẫn này, vì vậy hãy kiểm tra các tùy chọn hiện có trước khi áp dụng các ánh xạ bên dưới.
Kết nối base và chuẩn bị các trường
- Mở base Airtable mà bạn định dùng, thêm GenderAPI.io từ "Extensions" và chạy tiện ích. Hoàn tất các bước kết nối mà tiện ích mở rộng hiển thị.
- Chọn khóa tín dụng mà bạn muốn thao tác này sử dụng. Kiểm tra số dư còn lại và đảm bảo khóa này được liên kết với đúng tài khoản GenderAPI mà bạn định dùng.
- Chọn bảng và một trường nguồn chứa tên hoặc địa chỉ email. Giữ nguyên đầu vào gốc trong trường đó và tạo các trường riêng cho kết quả.
- Chọn trường đích giới tính bắt buộc và các trường đích bổ trợ tùy chọn. Dùng trường percent cho tỷ lệ phần trăm đã định dạng, hoặc trường number để giữ nguyên thang đo probability gốc.
- Quyết định có giữ nguyên các trường đích giới tính đã có giá trị hay không. Khi bật tùy chọn bỏ qua, các giá trị văn bản chưa được giải quyết từ những lần chạy trước cũng được giữ nguyên, vì vậy chỉ xóa những kết quả mà bạn chủ động muốn xử lý lại.
Ánh xạ đầu vào và đầu ra của tiện ích mở rộng
Trường nguồn có thể chứa lẫn tên và địa chỉ email. Trong phần triển khai đã được kiểm tra, giá trị chứa @ sẽ đi theo luồng xử lý địa chỉ email; quy tắc định tuyến này không xác minh rằng hộp thư có tồn tại.
| Thiết lập của tiện ích mở rộng | Bắt buộc | Giá trị và hành vi |
|---|---|---|
| Khóa tín dụng | Có | Khóa của tài khoản GenderAPI được chọn cung cấp tín dụng cho các truy vấn được xử lý. |
| Bảng và trường nguồn | Có | Ô nguồn cung cấp tên hoặc địa chỉ email. Các ô nguồn trống sẽ bị bỏ qua. |
| Trường đích giới tính | Có | Nhận trường gender gốc. Hãy tách riêng giá trị chưa được giải quyết khỏi male và female. |
| Trường đích quốc gia | Không | Nhận giá trị country được trả về. Đây là cột đầu ra, không phải bộ lọc quốc gia cho yêu cầu. |
| Trường đích probability | Không | Nhận giá trị probability của API cũ. Trường percent nhận giá trị đã chia cho 100; trường number giữ nguyên thang đo gốc. |
| Trường đích Found Name | Không | Nhận tên do API gốc trả về khi có. Hãy giữ ứng viên được suy luận này tách biệt với giá trị nguồn. |
| Bỏ qua các trường giới tính đã có giá trị | Không | Giữ nguyên các bản ghi mà trường đích đã có giá trị, kể cả văn bản chưa được giải quyết. Kiểm tra trạng thái của tùy chọn này trước mỗi lần chạy. |
Kiểm tra một lần chạy nhỏ trước khi xử lý toàn bộ bảng
Bắt đầu với một bảng kiểm thử nhỏ gồm một tên, một địa chỉ email, một ô trống và một đầu vào mơ hồ. Xác nhận các trường đích đã chọn và cách Airtable hiển thị thang đo probability trước khi xử lý bảng chính.
Trong mã của tiện ích mở rộng đã được xem xét, các giá trị mặc định khi chưa giải quyết được có thể xuất hiện dưới dạng văn bản null và probability 0. Một số phản hồi gốc không thành công cũng có thể để lại các giá trị mặc định này, còn lỗi kết nối có thể khiến bản ghi không thay đổi. Hãy xem xét trạng thái lần chạy và các hàng bị ảnh hưởng; chỉ riêng văn bản null không chứng minh rằng việc tra cứu đã hoàn tất thành công.
Kiểm tra các giá trị hiện có sau lần chạy. Hãy giữ lại các kết quả chưa được giải quyết để xem xét thay vì tự gán giới tính. Dự đoán dựa trên tên không xác minh bản dạng giới của một người, và quốc gia được trả về không phải là bằng chứng về nơi cư trú.
| Điều bạn thấy | Cách xử lý |
|---|---|
| Kết quả như mong đợi trong các cột dự định | Giữ lại đầu vào gốc và các trường bổ trợ để việc ánh xạ vẫn có thể được xem xét về sau. |
| Văn bản null hoặc probability 0 | Để ở trạng thái chưa giải quyết và xem xét trạng thái thao tác trước khi quyết định có nên tra cứu lại hay không. |
| Trường đích đã có giá trị từ trước vẫn không thay đổi | Kiểm tra thiết lập bỏ qua; đây có thể là việc giữ nguyên có chủ ý. |
| Thông báo về khóa hoặc tín dụng, hoặc kết quả không thay đổi sau lỗi | Giải quyết vấn đề về tài khoản hoặc kết nối và xác định các bản ghi bị ảnh hưởng trước khi chạy lại. |
Kiểm soát tín dụng được sử dụng và các lần chạy lại
Tiện ích mở rộng gốc tra cứu từng giá trị một bằng khóa GenderAPI đã chọn. Chạy lại cùng những bản ghi không bị bỏ qua có thể gửi các truy vấn mới và sử dụng tín dụng thêm lần nữa. Gói dịch vụ của chính Airtable và khả năng sử dụng tiện ích mở rộng là tách biệt với số dư tài khoản đó.
Đầu ra gốc không cung cấp phản hồi data/meta của V2, lựa chọn chế độ AI rõ ràng, đối tượng usage cho từng mục hay quy cách yêu cầu hàng loạt của V2. Hãy dùng tài liệu tham khảo V1 cũ cho quy trình làm việc này, và dùng lựa chọn API riêng biệt bên dưới khi bạn cần các tùy chọn đó.
Tiện ích mở rộng gửi các giá trị đã ánh xạ để xử lý và ghi kết quả trở lại base của bạn. Hãy xem xét chính sách xử lý dữ liệu đã công bố và các quyền của tiện ích mở rộng đối với những bản ghi bạn định xử lý; không đưa các trường không liên quan vào ánh xạ nguồn.
Dùng V2 khi bạn cần phản hồi có cấu trúc
Với một tích hợp tùy chỉnh, GenderAPI V2 chấp nhận tên, địa chỉ email và tên người dùng, đồng thời trả về các trường rõ ràng cho kết quả, độ tin cậy, nguồn và mức sử dụng. Hãy cấu hình kết nối đó riêng: việc đọc hướng dẫn V2 không thay đổi ứng dụng đã cài đặt hay các cột đầu ra của nó.
Các ví dụ Python và Node.js bao gồm yêu cầu đơn lẻ, yêu cầu hàng loạt, kết quả không xác định và lỗi vận hành. Hãy bắt đầu với hướng dẫn xác thực và chọn chế độ AI trước khi gửi một yêu cầu có tính phí.
Câu hỏi thường gặp
Tiện ích mở rộng Airtable có sử dụng GenderAPI V2 không?
Mã nguồn của tiện ích mở rộng được xem xét vào ngày 27 tháng 9 năm 2026 sử dụng các endpoint V1 cũ cho tên và địa chỉ email. Một kết nối V2 tùy chỉnh được xây dựng riêng có các trường yêu cầu và phản hồi khác, và không nâng cấp tiện ích mở rộng đã cài đặt.
Một trường nguồn có thể chứa cả tên và địa chỉ email không?
Có. Tiện ích mở rộng đã được kiểm tra chuyển các giá trị không trống có chứa @ sang tra cứu địa chỉ email và các giá trị còn lại sang tra cứu tên. Đây là việc định tuyến đầu vào, không phải xác minh hộp thư.
Vì sao probability hiển thị khác trong trường percent?
Tiện ích mở rộng chia giá trị probability của API cũ cho 100 đối với trường percent của Airtable để Airtable có thể định dạng giá trị đó thành tỷ lệ phần trăm. Trường đích kiểu number giữ nguyên thang đo gốc; đây không phải là trường confidence của V2.
Tùy chọn bỏ qua có giữ nguyên các kết quả chưa được giải quyết không?
Có, khi trường đích đã có giá trị. Điều này bao gồm cả văn bản null từ một lần chạy trước. Hãy xem xét những bản ghi đó và chỉ xóa các giá trị mà bạn chủ động muốn xử lý lại.
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.