ใช้ส่วนขยาย Airtable เพื่อจับคู่ฟิลด์
ส่วนขยาย GenderAPI อ่านชื่อหรืออีเมลจากฟิลด์ที่คุณเลือก แล้วเขียนสัญญาณเพศที่ได้จากการคาดการณ์ลงในฟิลด์ปลายทางที่แยกต่างหาก คุณยังจับคู่ประเทศ probability และชื่อที่พบ (Found Name) ได้ด้วย รวมถึงข้ามเรคคอร์ดที่ฟิลด์ปลายทางของเพศมีค่าอยู่แล้วได้
โค้ดต้นฉบับของส่วนขยายที่ตรวจสอบเมื่อวันที่ 27 กันยายน 2026 ใช้ endpoint V1 เดิมสำหรับชื่อและอีเมล รวมถึงฟิลด์การตอบกลับระดับบนสุด คู่มือนี้อธิบายเวิร์กโฟลว์ในตัวของส่วนขยายดังกล่าว ส่วนขยายที่ติดตั้งแล้วอาจเปลี่ยนแปลงได้โดยไม่ขึ้นกับคู่มือนี้ จึงควรตรวจสอบการตั้งค่าที่ใช้ได้ก่อนนำการจับคู่ด้านล่างไปใช้
เชื่อมต่อเบสและเตรียมฟิลด์
- เปิดเบส Airtable ที่ต้องการใช้ เพิ่ม GenderAPI.io จาก "Extensions" แล้วเรียกใช้ส่วนขยาย จากนั้นทำขั้นตอนการเชื่อมต่อที่ส่วนขยายแสดงให้เสร็จสิ้น
- เลือกคีย์ API เครดิตที่จะใช้กับงานนี้ ตรวจสอบยอดคงเหลือ และตรวจสอบว่าคีย์นี้เชื่อมโยงกับบัญชี GenderAPI ที่ตั้งใจไว้
- เลือกตารางและฟิลด์ต้นทางที่มีชื่อหรืออีเมล เก็บข้อมูลนำเข้าเดิมไว้ในฟิลด์นั้น และสร้างฟิลด์สำหรับผลลัพธ์แยกต่างหาก
- เลือกฟิลด์ปลายทางของเพศซึ่งจำเป็นต้องมี และฟิลด์ปลายทางเสริมที่ไม่บังคับ ใช้ฟิลด์ percent หากต้องการแสดงในรูปแบบร้อยละ หรือใช้ฟิลด์ number เพื่อคงสเกลเดิมของ probability
- ตัดสินใจว่าจะคงฟิลด์ปลายทางของเพศที่มีค่าอยู่แล้วไว้หรือไม่ การเปิดตัวเลือกข้ามจะคงค่าข้อความที่ระบุไม่ได้จากการเรียกใช้ครั้งก่อนไว้ด้วย ดังนั้นให้ล้างเฉพาะผลลัพธ์ที่ตั้งใจจะประมวลผลใหม่
จับคู่ข้อมูลนำเข้าและผลลัพธ์ของส่วนขยาย
ฟิลด์ต้นทางอาจมีทั้งชื่อและอีเมลปะปนกันได้ ในโค้ดที่ตรวจสอบ ค่าที่มีสัญลักษณ์ @ จะถูกส่งไปยังเส้นทางการประมวลผลอีเมล กฎการแยกเส้นทางนี้ไม่ได้ตรวจสอบว่ากล่องจดหมายมีอยู่จริง
| การตั้งค่าส่วนขยาย | จำเป็น | ค่าและลักษณะการทำงาน |
|---|---|---|
| คีย์ API เครดิต | ใช่ | คีย์ API ของบัญชี GenderAPI ที่เลือกเป็นแหล่งเครดิตสำหรับการค้นหาที่ประมวลผล |
| ตารางและฟิลด์ต้นทาง | ใช่ | เซลล์ต้นทางมีชื่อหรืออีเมล ระบบจะข้ามเซลล์ต้นทางที่ว่าง |
| ฟิลด์ปลายทางของเพศ | ใช่ | รับค่าจากฟิลด์ gender ของ API ที่ส่วนขยายใช้ แยกค่าที่ระบุไม่ได้ออกจาก male และ female |
| ฟิลด์ปลายทางของประเทศ | ไม่ | รับค่า country ที่ส่งคืน ฟิลด์นี้เป็นคอลัมน์ผลลัพธ์ ไม่ใช่ตัวกรองประเทศที่ใช้กับคำขอ |
| ฟิลด์ปลายทางของ probability | ไม่ | รับค่า probability จาก API เดิม ฟิลด์ percent จะได้รับค่าที่หารด้วย 100 ส่วนฟิลด์ number จะคงสเกลเดิม |
| ฟิลด์ปลายทางของ Found Name | ไม่ | รับชื่อที่ API ของส่วนขยายส่งคืนเมื่อมี แยกชื่อที่ได้จากการคาดการณ์นี้ออกจากค่าต้นทาง |
| ข้ามฟิลด์เพศที่มีค่าอยู่แล้ว | ไม่ | คงเรคคอร์ดที่ฟิลด์ปลายทางมีค่าอยู่แล้ว รวมถึงข้อความที่ระบุไม่ได้ ตรวจสอบว่าเลือกตัวเลือกนี้ไว้หรือไม่ก่อนเรียกใช้ทุกครั้ง |
ทดลองเรียกใช้กับชุดเล็กก่อนประมวลผลทั้งตาราง
เริ่มจากตารางทดสอบขนาดเล็กที่มีชื่อ อีเมล เซลล์ว่าง และข้อมูลนำเข้าที่กำกวม ตรวจสอบฟิลด์ปลายทางที่เลือกและวิธีที่ Airtable แสดงสเกลของ probability ก่อนประมวลผลตารางหลัก
ในโค้ดของส่วนขยายที่ตรวจสอบ ค่าเริ่มต้นของผลลัพธ์ที่ระบุไม่ได้อาจแสดงเป็นข้อความ null และ probability 0 การตอบกลับที่ไม่สำเร็จบางรายการจาก API ที่ส่วนขยายใช้ก็อาจทิ้งค่าเริ่มต้นเหล่านี้ไว้เช่นกัน ขณะที่ข้อผิดพลาดในการเชื่อมต่ออาจทำให้เรคคอร์ดไม่เปลี่ยนแปลง ตรวจสอบสถานะการเรียกใช้และแถวที่ได้รับผลกระทบ ข้อความ null เพียงอย่างเดียวไม่ได้พิสูจน์ว่าการค้นหาเสร็จสมบูรณ์
ตรวจสอบค่าที่มีอยู่หลังการเรียกใช้ อย่ากำหนดเพศเอง และเก็บผลลัพธ์ที่ระบุไม่ได้ไว้เพื่อการตรวจสอบ การคาดการณ์จากชื่อไม่ได้ยืนยันอัตลักษณ์ทางเพศของบุคคล และประเทศที่ส่งคืนไม่ได้พิสูจน์ถิ่นที่อยู่
| สิ่งที่เห็น | สิ่งที่ควรทำ |
|---|---|
| ผลลัพธ์ที่คาดไว้อยู่ในคอลัมน์ที่ตั้งใจ | เก็บข้อมูลนำเข้าเดิมและฟิลด์เสริมไว้ เพื่อให้ตรวจสอบการจับคู่ได้ในภายหลัง |
| ข้อความ null หรือ probability 0 | ปล่อยไว้เป็นค่าที่ระบุไม่ได้ และตรวจสอบสถานะของงานก่อนตัดสินใจว่าจะค้นหาอีกครั้งหรือไม่ |
| ฟิลด์ปลายทางที่เคยมีค่าไม่เปลี่ยนแปลง | ตรวจสอบการตั้งค่าการข้าม ผลลัพธ์นี้อาจเป็นการคงค่าไว้โดยตั้งใจ |
| ข้อความเกี่ยวกับคีย์หรือเครดิต หรือผลลัพธ์ไม่เปลี่ยนแปลงหลังเกิดข้อผิดพลาด | แก้ไขปัญหาบัญชีหรือการเชื่อมต่อ และระบุเรคคอร์ดที่ได้รับผลกระทบก่อนเริ่มใหม่ |
ควบคุมเครดิตที่เลือกและการเรียกใช้ซ้ำ
ส่วนขยายนี้ค้นหาค่าทีละรายการด้วยคีย์ GenderAPI ที่เลือก การเรียกใช้เรคคอร์ดเดิมที่ไม่ได้ข้ามอีกครั้งอาจส่งการค้นหาใหม่และหักเครดิตอีกครั้ง แพ็กเกจของ Airtable เองและความพร้อมใช้งานของส่วนขยายแยกจากยอดคงเหลือของบัญชีนี้
ผลลัพธ์ของส่วนขยายไม่มีการตอบกลับ data/meta ของ V2 การเลือกโหมด AI อย่างชัดเจน ออบเจ็กต์ usage ของแต่ละรายการ หรือข้อกำหนดคำขอแบบกลุ่มของ V2 ใช้ข้อมูลอ้างอิง V1 เดิมสำหรับเวิร์กโฟลว์นี้ และใช้ตัวเลือก API ที่แยกต่างหากด้านล่างเมื่อต้องการการควบคุมเหล่านี้
ส่วนขยายส่งค่าที่จับคู่ไว้ไปประมวลผลและเขียนผลลัพธ์กลับลงในเบส ตรวจสอบนโยบายความเป็นส่วนตัวที่เผยแพร่และสิทธิ์ของส่วนขยายสำหรับเรคคอร์ดที่จะประมวลผล และอย่านำฟิลด์ที่ไม่เกี่ยวข้องมารวมในการจับคู่ต้นทาง
ใช้ V2 เมื่อต้องการการตอบกลับที่มีโครงสร้าง
สำหรับการเชื่อมต่อที่คุณสร้างเอง GenderAPI V2 รับชื่อ อีเมล และชื่อผู้ใช้ แล้วส่งคืนฟิลด์ที่ระบุผลลัพธ์ ค่าความเชื่อมั่น แหล่งที่มา และการใช้งานอย่างชัดเจน ตั้งค่าการเชื่อมต่อนี้แยกต่างหาก การอ่านคู่มือ V2 ไม่ได้เปลี่ยนแอปที่ติดตั้งไว้หรือคอลัมน์ผลลัพธ์ที่แอปเขียน
ตัวอย่าง Python และ Node.js ครอบคลุมคำขอเดี่ยว คำขอแบบกลุ่ม ผลลัพธ์ที่ไม่ทราบ และข้อผิดพลาดในการดำเนินงาน เริ่มจากคู่มือการยืนยันตัวตน และเลือกโหมด AI ก่อนส่งคำขอที่มีการหักเครดิต
คำถามที่พบบ่อย
ส่วนขยาย Airtable ใช้ GenderAPI V2 หรือไม่?
โค้ดต้นฉบับของส่วนขยายที่ตรวจสอบเมื่อวันที่ 27 กันยายน 2026 ใช้ endpoint V1 เดิมสำหรับชื่อและอีเมล การเชื่อมต่อ V2 ที่สร้างขึ้นแยกต่างหากมีฟิลด์คำขอและฟิลด์การตอบกลับต่างออกไป และไม่ได้อัปเกรดส่วนขยายที่ติดตั้งไว้
ฟิลด์ต้นทางเดียวมีทั้งชื่อและอีเมลได้หรือไม่?
ได้ ส่วนขยายที่ตรวจสอบจะส่งค่าที่ไม่ว่างซึ่งมีสัญลักษณ์ @ ไปยังการค้นหาอีเมล และส่งค่าอื่นไปยังการค้นหาชื่อ นี่เป็นเพียงการแยกเส้นทางข้อมูลนำเข้า ไม่ใช่การตรวจสอบกล่องจดหมาย
ทำไม probability จึงแสดงต่างออกไปในฟิลด์ percent?
ส่วนขยายจะหารค่า probability จาก API เดิมด้วย 100 สำหรับฟิลด์ percent ของ Airtable เพื่อให้ Airtable แสดงในรูปแบบร้อยละได้ ฟิลด์ปลายทางประเภท number จะคงสเกลเดิม ค่านี้ไม่ใช่ฟิลด์ confidence ของ V2
ตัวเลือกข้ามจะคงผลลัพธ์ที่ระบุไม่ได้ไว้ด้วยหรือไม่?
ใช่ หากฟิลด์ปลายทางมีค่าอยู่แล้ว ซึ่งรวมถึงข้อความ null จากการเรียกใช้ครั้งก่อน ตรวจสอบเรคคอร์ดเหล่านั้น และล้างเฉพาะค่าที่ตั้งใจจะประมวลผลอีกครั้ง
แหล่งที่มาและเอกสาร
คู่มือนี้ตรวจทานล่าสุดเมื่อ ตรวจสอบวิธีติดตั้งได้ในเอกสารของแต่ละแพลตฟอร์ม และใช้เอกสาร API ด้านล่างเมื่อสร้างการเชื่อมต่อ V2 แยกต่างหาก