Ánh xạ bản ghi mới vào các cột kết quả
Tiện ích bổ sung GenderAPI có màn hình Workflows để ánh xạ các bản ghi mới trong trang tính vào cột giới tính và các cột kết quả tùy chọn khác. Hãy thiết lập cho đúng trang tính, sau đó kiểm tra một bản ghi thực sự được thêm vào trước khi dựa vào quy trình tự động này.
Quy trình làm việc riêng của tiện ích bổ sung tách biệt với một hành động HTTP gọi trực tiếp V2. Cách kích hoạt, thời điểm chạy và các trường đầu ra phụ thuộc vào tiện ích bổ sung đã cài đặt và tài khoản Google. Không có đảm bảo cập nhật tức thì cho mọi nguồn tạo hàng mới.
Tạo và kiểm thử quy trình
- Cài đặt và mở tiện ích bổ sung GenderAPI, sau đó mở Workflows từ menu của thanh bên.
- Chọn trang tính và khóa API của bạn. Chọn kiểu phân tích name, email hoặc username phù hợp với cột nguồn.
- Ánh xạ cột nguồn vào một cột giới tính riêng. Chỉ thêm nơi nhận kết quả probability, quốc gia và tên tìm thấy khi cần.
- Xem lại tất cả các ánh xạ trước khi tạo quy trình. Giao diện ngăn xung đột giữa các cột và có thể báo rằng quy trình đã tồn tại hoặc đã đạt giới hạn.
- Thêm một bản ghi tiêu biểu theo đúng cách mà dữ liệu sản xuất của bạn được thêm vào. Xác nhận rằng các giá trị xuất hiện ở đúng hàng và không có trường hiện có nào bị ghi đè.
- Kiểm thử một giá trị chưa xác định được và một lỗi vận hành, sau đó quyết định cách bạn sẽ phát hiện và xem lại các hàng bị bỏ sót hoặc thất bại.
Cấu hình các trường của quy trình trong tiện ích bổ sung
| Thiết lập | Loại | Cách dùng |
|---|---|---|
| Khóa API | Thông tin xác thực | Chọn đúng tài khoản và xác nhận rằng còn tín dụng khả dụng. |
| Trang tính | Lựa chọn trang tính | Trang tính có các bản ghi mà quy trình này cần xử lý. |
| Phương thức | Lựa chọn | name, email hoặc username. Phương thức đã chọn quyết định cách diễn giải đầu vào. |
| Cột nguồn | Tham chiếu cột | Giá trị cần phân tích trong mỗi bản ghi. |
| Cột giới tính | Tham chiếu cột | Nơi nhận kết quả tách biệt với đầu vào và các kết quả khác. |
| probability, quốc gia, tên tìm thấy | Nơi nhận kết quả tùy chọn | Các cột riêng cho những kết quả bổ sung của tiện ích bổ sung. |
Kiểm tra cách các hàng thực sự được thêm vào trang tính
Nhập giá trị thủ công, gửi biểu mẫu và nhập bản ghi từ CRM là các sự kiện khác nhau. Theo tài liệu của Google, các lần thực thi tập lệnh và yêu cầu API thường không kích hoạt trình kích hoạt có thể cài đặt. Trang niêm yết chính thức của tiện ích bổ sung không nêu rõ cách triển khai chính xác, vì vậy hãy kiểm thử với nguồn dữ liệu mà bạn thực sự sử dụng.
Đừng cho rằng một quy trình mới tạo sẽ xử lý ngược lại các hàng hiện có. Đối với những bản ghi đó, hãy chọn một phạm vi trong thanh bên để xử lý hàng loạt và ghi lại các hàng đã được xử lý.
Nếu một cập nhật dự kiến không xuất hiện, hãy kiểm tra quy trình, quyền, số dư của khóa, ánh xạ cột và lỗi nền tảng trước khi gửi lại cùng các bản ghi đó.
Đọ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ó.
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
Mỗi lần nhập dữ liệu từ CRM có kích hoạt quy trình của tiện ích bổ sung không?
Không nhất thiết. Hãy kiểm thử với một bản ghi từ CRM hoặc quy trình tự động mà bạn thực sự sử dụng. Google phân biệt giữa chỉnh sửa thủ công, gửi biểu mẫu và cập nhật qua API. Hãy kiểm tra cách hoạt động thực tế của tiện ích bổ sung đã cài đặt.
Tôi có thể xử lý các hàng đã có sẵn trong trang tính không?
Hãy chọn một phạm vi trong thanh bên để xử lý hàng loạt. Việc tạo quy trình cho hàng mới không xử lý các bản ghi hiện có.
Tôi có thể tạo bao nhiêu quy trình?
Giao diện có thể hiển thị một giới hạn, nhưng hướng dẫn này không nêu con số chưa được xác minh. Hãy kiểm tra phiên bản đã cài đặt và, nếu cần, xóa các quy trình không còn dùng đến.
Làm thế nào để nhận các trường source và usage của V2?
Hãy tạo một tích hợp HTTP riêng với V2, ví dụ theo các hướng dẫn đã được ghi lại cho Make hoặc Zapier. Đừng cho rằng các cột của tiện ích bổ sung chứa cấu trúc phản hồi của V2.
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.