Bắt đầu xử lý tệp từ bảng điều khiển tài khoản
Công cụ xử lý tệp của GenderAPI đọc một bảng tính, cho phép bạn ánh xạ một cột tên, địa chỉ email hoặc tên người dùng và tạo tệp CSV xuất ra đã được bổ sung kết quả. Hãy dùng công cụ này để xử lý dựa trên tệp khi bạn không cần xây dựng tích hợp API.
Quy trình làm việc trong bảng điều khiển tài khoản này tách biệt với các yêu cầu hàng loạt của REST V2. Tệp không phải là một yêu cầu JSON V2, vì vậy giới hạn theo từng mục và các đường dẫn phản hồi của V2 không áp dụng cho quá trình xử lý gốc này.
Sử dụng định dạng được trình chọn tệp chấp nhận
Trình chọn tệp hiện tại chỉ chấp nhận 1 tệp mỗi lần. Với sổ làm việc có nhiều trang tính, hãy chọn đúng trang tính và kiểm tra các giá trị đã được đọc. Nếu tệp ở định dạng khác, hãy xuất tệp sang một trong các định dạng nêu trên trước khi bắt đầu.
Quá trình xử lý phụ thuộc vào độ phức tạp của tệp, số hàng, phương thức đã chọn, tín dụng của tài khoản và tải của dịch vụ. Hãy kiểm thử với một tệp tiêu biểu; hướng dẫn này không cam kết kích thước tệp tối đa cố định hay thời gian xử lý cố định.
| Định dạng | Phần mở rộng được chấp nhận |
|---|---|
| CSV | .csv |
| Excel | .xls, .xlsx |
| Apple Numbers | .numbers |
| OpenDocument | .ods |
| Giá trị phân tách bằng tab | .tsv |
| Văn bản | .txt |
Kiểm tra các đề xuất trước khi bắt đầu xử lý
- Tạo một bản sao chỉ chứa dữ liệu cần thiết. Đặt đầu vào trong một cột có tên rõ ràng và đặt các mã quốc gia 2 chữ cái đáng tin cậy, nếu có, trong một cột riêng.
- Đăng nhập, mở công cụ Excel/CSV, chọn đúng khóa rồi chọn tệp và trang tính.
- Trong khi thiết lập trang tính, công cụ có thể gửi các ô mẫu để đề xuất cột với sự hỗ trợ của AI. Hãy tự kiểm tra loại đầu vào và các cột được đề xuất trước khi tiếp tục.
- Chọn phân tích tên, địa chỉ email hoặc tên người dùng, xác nhận cột nguồn và ánh xạ quốc gia tùy chọn, sau đó kiểm tra các tùy chọn AI và xuất tệp mà công cụ hiển thị.
- Bắt đầu xử lý và theo dõi tiến độ. Đừng tải lên cùng một tệp nhiều lần chỉ vì quá trình xử lý chưa hoàn tất.
- Khi tệp xuất đã sẵn sàng, hãy tải xuống tệp CSV, kiểm tra sự khớp nhau của các hàng và xem lại các bản ghi identified, không xác định và thất bại. Hãy giữ tệp nguồn để đối chiếu.
Kiểm tra các thiết lập xử lý tệp
| Thiết lập | Loại | Mô tả |
|---|---|---|
| Khóa API | Thông tin xác thực của tài khoản | Tài khoản có số dư được dùng cho lần xử lý này. |
| Tệp và trang tính | Chọn tệp | Một tệp ở định dạng được chấp nhận và đúng trang tính. |
| Phương thức | Lựa chọn | name, email hoặc username. Hãy kiểm tra giá trị được đề xuất tự động. |
| Cột nguồn | Ánh xạ cột | Đầu vào cần phân tích trong mỗi hàng; hãy kiểm tra hàng tiêu đề và các giá trị mẫu. |
| Ngữ cảnh quốc gia | Cột hoặc thiết lập tùy chọn | Dùng mã quốc gia 2 chữ cái đã biết khi phù hợp. |
| Tùy chọn AI và xuất tệp | Các điều khiển hiện tại của công cụ | Kiểm tra các thiết lập được hiển thị trước khi xử lý; đây không phải là tham số ai_mode của V2. |
Đọc các cột kết quả
Tệp CSV được xuất ra bổ sung các trường kết quả gốc gender, country, probability và found_name. Trước khi nhập vào hệ thống khác, hãy xác nhận rằng các hàng khớp từng hàng với tệp gốc và kiểm tra các tiêu đề cột. Kết quả được cung cấp ở định dạng CSV ngay cả khi đầu vào là một sổ làm việc Excel.
Kết quả ước tính là các mối liên hệ được suy luận. Hãy giữ chúng tách biệt với giới tính do chính người đó tự công bố và thông tin quốc gia đã được xác minh.
- 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ó.
Lưu ý về phân tích trong bước thiết lập và việc lưu giữ tệp
Việc chọn trang tính có thể gửi các ô mẫu để ánh xạ cột với sự hỗ trợ của AI trước khi bước xử lý cuối cùng bắt đầu. Đừng cho rằng mọi dữ liệu vẫn nằm trên thiết bị của bạn cho đến khi bạn bắt đầu xử lý. Hãy xóa các cột không cần thiết và đọc Chính sách quyền riêng tư trước khi chọn một tệp chứa dữ liệu cá nhân.
Sau khi xuất tệp, hãy dùng thao tác xóa hiện có khi bạn không còn cần bản sao trong không gian làm việc. Chính sách đã công bố mô tả việc xóa theo lịch khỏi các hệ thống đang hoạt động và việc lưu giữ trong bản sao lưu; một lịch xóa không chứng minh rằng mọi bản sao đều đã bị xóa.
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
Công cụ này có chấp nhận tệp XLSM không?
Trình chọn tệp hiện tại liệt kê các định dạng CSV, XLS, XLSX, Numbers, ODS, TSV và TXT. Hãy xuất sổ làm việc XLSM sang một trong các định dạng này và kiểm tra các giá trị đã xuất trước khi tải lên.
Các đề xuất cột có luôn chính xác không?
Không. Hãy kiểm tra loại đầu vào, cách xử lý hàng tiêu đề, cột nguồn và ánh xạ quốc gia. Trong quá trình thiết lập, dữ liệu mẫu có thể được gửi đi để nhận đề xuất với sự hỗ trợ của AI.
Tôi có nhận lại sổ làm việc Excel gốc không?
Quy trình xử lý được mô tả xuất kết quả ở định dạng CSV. Hãy kiểm tra các cột đã xuất và sự khớp nhau của các hàng trước khi chuyển chúng vào sổ làm việc gốc hoặc một công cụ khác.
Đây có giống với yêu cầu hàng loạt V2 không?
Không. Đây là quá trình xử lý tệp trong bảng điều khiển tài khoản với các tùy chọn và quy trình riêng. Hãy dùng tài liệu về yêu cầu hàng loạt V2 khi bạn tạo các yêu cầu JSON trong tích hợp của riêng mì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.