ใช้แถบด้านข้างประมวลผลแถวในช่วงที่กำหนด
ส่วนเสริม GenderAPI สำหรับ Google Sheets อ่านคอลัมน์ชื่อ อีเมล หรือชื่อผู้ใช้ แล้วเขียนฟิลด์ผลลัพธ์ที่เลือกลงในชีต แถบด้านข้างเหมาะเมื่อต้องการเลือกช่วงแถวและบันทึกค่าผลลัพธ์โดยไม่ต้องคงสูตรไว้ในทุกเซลล์
นี่คือเวิร์กโฟลว์ในตัวของส่วนเสริม คอลัมน์ผลลัพธ์ที่มีอยู่และวิธีประมวลผลงานแยกจากรูปแบบการตอบกลับของ REST API V2 สาธารณะ
ติดตั้ง เชื่อมต่อ แล้วทดสอบกับตัวอย่างขนาดเล็ก
- ติดตั้งส่วนเสริมจากหน้ารายการอย่างเป็นทางการใน Google Workspace Marketplace และตรวจสอบสิทธิ์ที่ขอ ใน Google Sheets ให้เปิด Extensions (ส่วนขยาย) → GenderAPI → Determine Gender
- เลือกคีย์ GenderAPI หรือป้อนคีย์ในแถบด้านข้าง ตรวจสอบว่าบัญชีที่เลือกมีเครดิตพร้อมใช้
- เลือกชีตและวิธีป้อนข้อมูล (name, email หรือ username) จากนั้นเลือกคอลัมน์ต้นฉบับที่ตรงกันและช่วงแถวขนาดเล็กที่ไม่รวมแถวส่วนหัว
- เลือกคอลัมน์แยกสำหรับเขียนเพศ และหากต้องการ ให้เลือกคอลัมน์สำหรับ probability ประเทศ และชื่อที่พบ อย่าเขียนทับค่าต้นฉบับ
- หากมีบริบทประเทศที่เชื่อถือได้ ให้ใช้การตั้งค่าประเทศที่มีให้หรือคอลัมน์รหัสประเทศ อย่าอนุมานบริบทจากการคาดการณ์ที่กำลังจะขอ
- ตรวจสอบตัวเลือกข้ามผลลัพธ์ที่มีอยู่ เริ่มงาน แล้วตรวจดูแถวที่เลือกก่อนขยายช่วง
จับคู่ข้อมูลนำเข้าและตำแหน่งผลลัพธ์
| การตั้งค่า | ชนิด | สิ่งที่ต้องเลือก |
|---|---|---|
| คีย์ API | ข้อมูลรับรองของบัญชี | ใช้คีย์ที่เลือกไว้ในส่วนเสริม และตรวจสอบยอดคงเหลือกับความถูกต้องของคีย์ |
| วิธี | ตัวเลือก | เลือก name, email หรือ username ให้ตรงกับคอลัมน์ต้นฉบับ |
| ชีตและช่วงแถว | ชีตและหมายเลขแถว | เลือกเฉพาะแถวที่จะประมวลผลและไม่รวมแถวส่วนหัว |
| คอลัมน์ต้นฉบับ | การอ้างอิงคอลัมน์ | คอลัมน์ข้อมูลนำเข้าเพียงคอลัมน์เดียวสำหรับวิธีที่เลือก |
| บริบทประเทศ | การตั้งค่าหรือคอลัมน์ที่ไม่บังคับ | ใช้รหัสประเทศ 2 ตัวอักษรที่เชื่อถือได้เมื่อมี |
| คอลัมน์ผลลัพธ์ | การอ้างอิงคอลัมน์ | เพศเป็นตำแหน่งผลลัพธ์หลัก ส่วน probability ประเทศ และชื่อที่พบเป็นตัวเลือกเพิ่มเติม |
| ข้ามผลลัพธ์ที่มีอยู่ | ช่องทำเครื่องหมาย | ตรวจสอบการตั้งค่าปัจจุบันเพื่อไม่ให้การเรียกใช้ซ้ำเขียนทับแถวที่เสร็จแล้วโดยไม่ตั้งใจ |
อ่านคอลัมน์ผลลัพธ์ของส่วนเสริม
เก็บข้อมูลนำเข้าเดิมไว้ข้างผลลัพธ์ ความเชื่อมโยงที่อิงจากชื่อไม่ได้ยืนยันเพศที่บุคคลระบุด้วยตนเอง และประเทศที่ส่งคืนไม่ใช่ถิ่นที่อยู่หรือสัญชาติที่ได้รับการยืนยัน
- ตรวจดูผลลัพธ์ทั่วไป ข้อมูลนำเข้าที่กำกวม และงานที่ล้มเหลวอย่างละหนึ่งกรณีก่อนประมวลผลทั้งชุดข้อมูล
- เซลล์ว่าง ข้อความ null และข้อผิดพลาดของสูตรเป็นค่าที่ต่างกันในสเปรดชีต ปรับผลลัพธ์ unknown ให้เป็นรูปแบบเดียวกันอย่างตั้งใจโดยไม่ซ่อนข้อผิดพลาด
- ใช้การจัดการสำรองที่เป็นกลางสำหรับเรคคอร์ดที่ไม่ทราบหรือไม่แน่นอน เก็บข้อมูลโปรไฟล์ที่บุคคลให้ไว้แยกจากคอลัมน์ที่ได้จากการคาดการณ์
| ผลลัพธ์ | ชนิดโดยทั่วไป | วิธีใช้ |
|---|---|---|
| Gender | ข้อความหรือค่าที่ยังระบุไม่ได้ | คงค่า male หรือ female ไว้เฉพาะผลลัพธ์ที่สำเร็จ เก็บค่าที่ยังระบุไม่ได้เป็น unknown และตรวจสอบข้อความข้อผิดพลาดแยกต่างหาก |
| Probability | ตัวเลข (เมื่อมี) | สัญญาณความเชื่อมั่นแบบเดิม ไม่ใช่ฟิลด์ confidence ของ V2 และไม่ใช่อัตราความแม่นยำที่วัดจากชุดข้อมูลของคุณ |
| Country | ข้อความ (เมื่อมี) | บริบทที่ส่งคืนจากการค้นหา เก็บแยกจากประเทศของลูกค้าที่ได้รับการยืนยัน |
| Found / normalized name | ข้อความ (เมื่อมี) | ชื่อที่ใช้หรือแยกออกมาระหว่างการประมวลผล ตรวจสอบค่านี้เมื่ออีเมลหรือชื่อผู้ใช้กำกวม |
วางแผนเรื่องเครดิต ขีดจำกัด และการเรียกใช้ซ้ำ
บัญชี GenderAPI แบบฟรีที่ลงทะเบียนแล้วมีเครดิตวันละ 200 เครดิต เครดิตคือยอดคงเหลือของบัญชี ไม่ได้รับประกันผลลัพธ์ที่สำเร็จ 200 รายการในทุกเวิร์กโฟลว์ ตรวจสอบยอดคงเหลือของคีย์ที่เลือกและตัวเลือกการประมวลผลปัจจุบันของเครื่องมือก่อนเริ่ม
ส่วนเสริมในตัวและงานไฟล์มีเส้นทางการประมวลผลของตนเอง ขีดจำกัดคำขอแบบกลุ่ม ตัวเลือก AI และฟิลด์การหักเครดิตรายคำขอของ REST API V2 ไม่ได้มีผลกับส่วนเหล่านี้โดยอัตโนมัติ การเรียกใช้ซ้ำหรือการคำนวณใหม่อาจส่งงานใหม่ได้ จึงไม่ควรถือว่าไม่มีค่าใช้จ่าย
เริ่มจากตัวอย่างขนาดเล็ก เก็บผลลัพธ์ที่เสร็จแล้ว และตรวจสอบแถวที่ล้มเหลวก่อนเรียกใช้ซ้ำ หากต้องแก้ไขเพียงการส่งออกหรือการอัปเดตแอปปลายทางในภายหลัง ให้ใช้ผลลัพธ์ที่มีอยู่แล้วซ้ำ
เลือกข้อมูลที่จะแชร์
การเชื่อมต่อกับสเปรดชีตจะส่งค่าที่จำเป็นต่อการค้นหา และต้องได้รับสิทธิ์เพื่อทำงานกับเอกสารที่เลือก ตรวจสอบสิทธิ์การเข้าถึงไฟล์สเปรดชีต บัญชีที่เชื่อมต่อ และคอลัมน์ผลลัพธ์ก่อนประมวลผลข้อมูลส่วนบุคคล
เก็บคีย์ API ไว้ในการตั้งค่าของส่วนเสริม ไม่ใช่ในเซลล์ทั่วไป ภาพหน้าจอ หรือตัวอย่างที่แชร์ นโยบายความเป็นส่วนตัวที่เผยแพร่อธิบายการจัดการข้อมูลนำเข้า การเก็บรักษา และบันทึกการทำงาน การเชื่อมต่อกับสเปรดชีตไม่ได้หมายความว่าข้อมูลจะอยู่บนอุปกรณ์ของคุณเท่านั้น
เมื่อใดควรใช้ API V2 โดยตรง
หากแอปพลิเคชันต้องใช้ตัวเลือก AI ที่ระบุชัดเจน และข้อมูล status, source, confidence_kind และ usage รายรายการจาก V2 ให้ใช้การเชื่อมต่อ HTTP แยกต่างหาก ทำตามข้อกำหนดคำขอและการตอบกลับของ V2 การเพิ่มชื่อฟิลด์ของ V2 ลงในสูตรในตัวหรือส่วนเสริมที่มีอยู่ไม่ได้เปลี่ยนการทำงานของไคลเอนต์นั้น
คำถามที่พบบ่อย
ต้องเขียนโค้ดเพื่อใช้แถบด้านข้างหรือไม่?
ไม่ต้อง ติดตั้งส่วนเสริม เชื่อมต่อคีย์ แล้วจับคู่คอลัมน์ต้นฉบับกับคอลัมน์ผลลัพธ์ การเชื่อมต่อกับ API V2 โดยตรงเป็นอีกทางเลือกหนึ่งสำหรับแอปพลิเคชันที่พัฒนาเอง
ประมวลผลแถวที่มีอยู่แล้วได้หรือไม่?
ได้ ใช้การตั้งค่าชีตและช่วงแถวในแถบด้านข้าง ตรวจสอบแถวส่วนหัว ชนิดข้อมูลนำเข้า คอลัมน์ผลลัพธ์ และการตั้งค่าผลลัพธ์ที่มีอยู่ก่อนเริ่ม
คอลัมน์ผลลัพธ์คือการตอบกลับ JSON ของ V2 หรือไม่?
ไม่ใช่ งานในตัวจะเขียนฟิลด์สเปรดชีตที่รองรับ ออบเจ็กต์ data และ meta รวมถึงฟิลด์ source และ confidence_kind เป็นส่วนของข้อกำหนดการเชื่อมต่อกับ REST API V2 โดยตรง
ควรจัดการผลลัพธ์ unknown อย่างไร?
คงไว้เป็น unknown และแยกออกจากงานที่ล้มเหลว ตรวจสอบข้อมูลนำเข้าที่กำกวม และใช้การจัดการสำรองที่เป็นกลางแทนการกำหนดเพศโดยอัตโนมัติ
แหล่งที่มาและเอกสาร
คู่มือนี้ตรวจทานล่าสุดเมื่อ ตรวจสอบวิธีติดตั้งได้ในเอกสารของแต่ละแพลตฟอร์ม และใช้เอกสาร API ด้านล่างเมื่อสร้างการเชื่อมต่อ V2 แยกต่างหาก