Xử lý các hàng đã chọn từ thanh bên
Tiện ích bổ sung GenderAPI cho Google Sheets đọc một cột tên, địa chỉ email hoặc tên người dùng và ghi các trường kết quả đã chọn vào trang tính. Từ thanh bên, bạn có thể xử lý một phạm vi hàng cụ thể và lưu các giá trị kết quả mà không để lại công thức trong từng ô.
Đây là quy trình làm việc riêng của tiện ích bổ sung. Các cột kết quả và việc xử lý hàng loạt của tiện ích bổ sung tách biệt với định dạng phản hồi công khai của REST API V2.
Cài đặt, kết nối và kiểm thử với một mẫu nhỏ
- Cài đặt tiện ích bổ sung từ trang niêm yết chính thức trên Google Workspace Marketplace và xem lại các quyền được yêu cầu. Trong Google Sheets, mở Tiện ích mở rộng (Extensions) → GenderAPI → Determine Gender.
- Chọn khóa API GenderAPI của bạn hoặc nhập khóa vào thanh bên. Xác nhận rằng tài khoản đã chọn còn tín dụng khả dụng.
- Chọn trang tính và phương thức name, email hoặc username. Chỉ định cột nguồn tương ứng và một phạm vi hàng nhỏ không bao gồm hàng tiêu đề.
- Chọn một cột riêng 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. Không ghi đè lên các giá trị gốc.
- Nếu bạn có ngữ cảnh địa lý đáng tin cậy, hãy dùng tùy chọn quốc gia hoặc một cột mã quốc gia. Không suy ra ngữ cảnh này từ chính ước tính mà bạn sắp yêu cầu.
- Xem lại tùy chọn bỏ qua kết quả hiện có, bắt đầu xử lý và kiểm tra các hàng đã chọn trước khi mở rộng phạm vi.
Ánh xạ dữ liệu đầu vào và nơi nhận kết quả
| Thiết lập | Loại | Lựa chọn và mô tả |
|---|---|---|
| Khóa API | Định danh tài khoản | Dùng khóa đã chọn trong tiện ích bổ sung và xác nhận rằng khóa hợp lệ và còn số dư. |
| Phương thức | Lựa chọn | name, email hoặc username, tùy theo cột nguồn. |
| Trang tính và phạm vi hàng | Trang tính và số hàng | Chỉ chọn các hàng cần xử lý và loại trừ hàng tiêu đề. |
| Cột nguồn | Tham chiếu cột | Cột đầu vào duy nhất cho phương thức đã chọn. |
| Ngữ cảnh địa lý | Thiết lập hoặc cột tùy chọn | Dùng mã quốc gia gồm 2 chữ cái đáng tin cậy, nếu có. |
| Cột kết quả | Tham chiếu cột | Giới tính là nơi nhận kết quả chính. Các cột probability, quốc gia và tên tìm thấy là tùy chọn. |
| Bỏ qua kết quả hiện có | Hộp kiểm | Xem lại thiết lập này để lần chạy lại không vô tình thay thế các hàng đã được điền. |
Đọ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ó cần viết mã để dùng thanh bên không?
Không. Hãy cài đặt tiện ích bổ sung, kết nối khóa và ánh xạ cột nguồn cùng các cột kết quả. Tích hợp trực tiếp với API V2 là một lựa chọn riêng dành cho các ứng dụng tùy chỉnh.
Tôi có thể xử lý các hàng hiện có không?
Có. Hãy dùng thiết lập trang tính và phạm vi hàng trong thanh bên. Trước khi bắt đầu xử lý, hãy xem lại hàng tiêu đề, loại đầu vào, các cột đích và tùy chọn dành cho kết quả hiện có.
Các cột kết quả có khớp với phản hồi JSON của V2 không?
Không. Quy trình xử lý riêng của tiện ích bổ sung ghi các trường được hỗ trợ vào trang tính. Các đối tượng data và meta cùng các trường source và confidence_kind thuộc về đặc tả của REST API V2 khi bạn gọi trực tiếp.
Tôi nên xử lý kết quả không xác định như thế nào?
Lưu kết quả đó là unknown và phân biệt với một lần chạy thất bại. Hãy xem lại các đầu vào không rõ ràng và dùng cách diễn đạt trung lập thay vì tự động gán giới tính.
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.