# จับคู่ชื่อและอีเมลด้วยส่วนขยาย GenderAPI สำหรับ Airtable

> ตั้งค่าส่วนขยาย Airtable จับคู่เพศ ประเทศ และ probability เก็บค่าเดิมไว้ และตรวจสอบเรคคอร์ดที่ระบุไม่ได้ พร้อมทำความเข้าใจว่าการเชื่อมต่อ V1 ในตัวของส่วนขยายแตกต่างจากตัวเลือก V2 ที่แยกต่างหากอย่างไร

Canonical HTML: https://www.genderapi.io/th/blog/how-to-determine-gender-from-airtable-data

Last reviewed: 2026-09-30

## ใช้ส่วนขยาย Airtable เพื่อจับคู่ฟิลด์

ส่วนขยาย GenderAPI อ่านชื่อหรืออีเมลจากฟิลด์ที่คุณเลือก แล้วเขียนสัญญาณเพศที่ได้จากการคาดการณ์ลงในฟิลด์ปลายทางที่แยกต่างหาก คุณยังจับคู่ประเทศ probability และชื่อที่พบ (Found Name) ได้ด้วย รวมถึงข้ามเรคคอร์ดที่ฟิลด์ปลายทางของเพศมีค่าอยู่แล้วได้

โค้ดต้นฉบับของส่วนขยายที่ตรวจสอบเมื่อวันที่ 27 กันยายน 2026 ใช้ endpoint V1 เดิมสำหรับชื่อและอีเมล รวมถึงฟิลด์การตอบกลับระดับบนสุด คู่มือนี้อธิบายเวิร์กโฟลว์ในตัวของส่วนขยายดังกล่าว ส่วนขยายที่ติดตั้งแล้วอาจเปลี่ยนแปลงได้โดยไม่ขึ้นกับคู่มือนี้ จึงควรตรวจสอบการตั้งค่าที่ใช้ได้ก่อนนำการจับคู่ด้านล่างไปใช้

- [GenderAPI.io ใน Airtable Marketplace](https://airtable.com/marketplace/blkqCasjQIqmmBrmb/gender-api-io-determine-gender)
- [ข้อมูลอ้างอิงการตอบกลับ V1](https://www.genderapi.io/th/api-documentation/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 ที่แยกต่างหากด้านล่างเมื่อต้องการการควบคุมเหล่านี้

ส่วนขยายส่งค่าที่จับคู่ไว้ไปประมวลผลและเขียนผลลัพธ์กลับลงในเบส ตรวจสอบนโยบายความเป็นส่วนตัวที่เผยแพร่และสิทธิ์ของส่วนขยายสำหรับเรคคอร์ดที่จะประมวลผล และอย่านำฟิลด์ที่ไม่เกี่ยวข้องมารวมในการจับคู่ต้นทาง

- [ราคาและเครดิตของ GenderAPI](https://www.genderapi.io/th/price)
- [นโยบายความเป็นส่วนตัว](https://www.genderapi.io/th/privacy-policy)

## ใช้ V2 เมื่อต้องการการตอบกลับที่มีโครงสร้าง

สำหรับการเชื่อมต่อที่คุณสร้างเอง GenderAPI V2 รับชื่อ อีเมล และชื่อผู้ใช้ แล้วส่งคืนฟิลด์ที่ระบุผลลัพธ์ ค่าความเชื่อมั่น แหล่งที่มา และการใช้งานอย่างชัดเจน ตั้งค่าการเชื่อมต่อนี้แยกต่างหาก การอ่านคู่มือ V2 ไม่ได้เปลี่ยนแอปที่ติดตั้งไว้หรือคอลัมน์ผลลัพธ์ที่แอปเขียน

ตัวอย่าง Python และ Node.js ครอบคลุมคำขอเดี่ยว คำขอแบบกลุ่ม ผลลัพธ์ที่ไม่ทราบ และข้อผิดพลาดในการดำเนินงาน เริ่มจากคู่มือการยืนยันตัวตน และเลือกโหมด AI ก่อนส่งคำขอที่มีการหักเครดิต

- [การยืนยันตัวตน V2](https://www.genderapi.io/th/docs/v2/authentication)
- [ฟิลด์การตอบกลับ V2](https://www.genderapi.io/th/docs/v2/responses)
- [ตัวอย่างการเชื่อมต่อ Python](https://www.genderapi.io/th/integrations/python)
- [ตัวอย่างการเชื่อมต่อ Node.js](https://www.genderapi.io/th/integrations/javascript)

## ส่วนขยาย Airtable ใช้ GenderAPI V2 หรือไม่?

โค้ดต้นฉบับของส่วนขยายที่ตรวจสอบเมื่อวันที่ 27 กันยายน 2026 ใช้ endpoint V1 เดิมสำหรับชื่อและอีเมล การเชื่อมต่อ V2 ที่สร้างขึ้นแยกต่างหากมีฟิลด์คำขอและฟิลด์การตอบกลับต่างออกไป และไม่ได้อัปเกรดส่วนขยายที่ติดตั้งไว้

## ฟิลด์ต้นทางเดียวมีทั้งชื่อและอีเมลได้หรือไม่?

ได้ ส่วนขยายที่ตรวจสอบจะส่งค่าที่ไม่ว่างซึ่งมีสัญลักษณ์ @ ไปยังการค้นหาอีเมล และส่งค่าอื่นไปยังการค้นหาชื่อ นี่เป็นเพียงการแยกเส้นทางข้อมูลนำเข้า ไม่ใช่การตรวจสอบกล่องจดหมาย

## ทำไม probability จึงแสดงต่างออกไปในฟิลด์ percent?

ส่วนขยายจะหารค่า probability จาก API เดิมด้วย 100 สำหรับฟิลด์ percent ของ Airtable เพื่อให้ Airtable แสดงในรูปแบบร้อยละได้ ฟิลด์ปลายทางประเภท number จะคงสเกลเดิม ค่านี้ไม่ใช่ฟิลด์ confidence ของ V2

## ตัวเลือกข้ามจะคงผลลัพธ์ที่ระบุไม่ได้ไว้ด้วยหรือไม่?

ใช่ หากฟิลด์ปลายทางมีค่าอยู่แล้ว ซึ่งรวมถึงข้อความ null จากการเรียกใช้ครั้งก่อน ตรวจสอบเรคคอร์ดเหล่านั้น และล้างเฉพาะค่าที่ตั้งใจจะประมวลผลอีกครั้ง

## แหล่งที่มาและเอกสาร

- [หน้ารายการอย่างเป็นทางการ: Airtable](https://airtable.com/marketplace/blkqCasjQIqmmBrmb/gender-api-io-determine-gender)
- [เอกสาร GenderAPI V1](https://www.genderapi.io/th/api-documentation/v1)
- [เอกสาร API V2 แยกต่างหาก](https://www.genderapi.io/th/api-documentation)