เรียกใช้งานไฟล์จากแดชบอร์ดบัญชี
เครื่องมือไฟล์ของ GenderAPI อ่านสเปรดชีต ให้คุณจับคู่คอลัมน์ชื่อ ที่อยู่อีเมล หรือชื่อผู้ใช้ แล้วเตรียมไฟล์ CSV ที่เพิ่มข้อมูลแล้วสำหรับส่งออก ใช้เครื่องมือนี้กับงานที่ใช้ไฟล์เมื่อไม่จำเป็นต้องสร้างการเชื่อมต่อ API เอง
เวิร์กโฟลว์ไฟล์ในแดชบอร์ดแยกจากคำขอแบบกลุ่มของ REST V2 ไฟล์ไม่ใช่คำขอ JSON ของ V2 และไม่ควรนำขีดจำกัดต่อรายการและเส้นทางการตอบกลับของ V2 มาใช้กับงานในตัวนี้
ใช้รูปแบบที่ตัวเลือกอัปโหลดยอมรับ
ตัวเลือกอัปโหลดในปัจจุบันเลือกได้ครั้งละ 1 ไฟล์ สำหรับเวิร์กบุ๊กที่มีหลายชีต ให้เลือกชีตที่ถูกต้องและตรวจสอบค่าที่อ่านเข้ามา หากตัวเลือกอัปโหลดไม่ยอมรับรูปแบบไฟล์ ให้ส่งออกไฟล์เป็นรูปแบบใดรูปแบบหนึ่งในรายการก่อนเริ่ม
ความซับซ้อนของไฟล์ จำนวนแถว วิธีที่เลือก เครดิตของบัญชี และภาระของบริการมีผลต่อการประมวลผล ทดสอบด้วยไฟล์ที่เป็นตัวแทนของข้อมูลจริง คู่มือนี้ไม่ได้รับประกันขนาดสูงสุดหรือเวลาประมวลผลที่แน่นอน
| รูปแบบ | นามสกุลไฟล์ที่ยอมรับ |
|---|---|
| CSV | .csv |
| Excel | .xls, .xlsx |
| Apple Numbers | .numbers |
| OpenDocument | .ods |
| ค่าที่คั่นด้วยแท็บ | .tsv |
| ข้อความ | .txt |
ตรวจสอบคำแนะนำก่อนเริ่มงาน
- สร้างสำเนาที่มีเฉพาะข้อมูลที่งานต้องใช้ วางข้อมูลนำเข้าไว้ในคอลัมน์ที่ตั้งชื่อชัดเจน และหากมีรหัสประเทศ 2 ตัวอักษรที่เชื่อถือได้ ให้วางไว้ในคอลัมน์แยกต่างหาก
- เข้าสู่ระบบ เปิดเครื่องมือ Excel/CSV เลือกคีย์ที่ถูกต้อง แล้วเลือกไฟล์และชีต
- ระหว่างตั้งค่าชีต เครื่องมืออาจส่งเซลล์ตัวอย่างเพื่อให้ AI ช่วยแนะนำคอลัมน์ ตรวจสอบประเภทข้อมูลนำเข้าและคอลัมน์ที่แนะนำด้วยตนเองก่อนดำเนินการต่อ
- เลือกการวิเคราะห์ชื่อ ที่อยู่อีเมล หรือชื่อผู้ใช้ ยืนยันคอลัมน์ต้นทางและการจับคู่ประเทศที่ไม่บังคับ แล้วตรวจทานตัวเลือก AI และการส่งออกที่เครื่องมือแสดงอยู่ในขณะนั้น
- เริ่มการประมวลผลและติดตามความคืบหน้า อย่าส่งไฟล์เดียวกันซ้ำหลายครั้งเพียงเพราะงานยังไม่เสร็จ
- เมื่อไฟล์ส่งออกพร้อม ให้ดาวน์โหลดไฟล์ CSV ตรวจสอบว่าแถวตรงกับต้นฉบับ แล้วตรวจทานผลลัพธ์ identified ผลลัพธ์ที่ไม่ทราบ และเรคคอร์ดที่ล้มเหลว เก็บไฟล์ต้นฉบับไว้เพื่อเปรียบเทียบ
ตรวจสอบการตั้งค่างานไฟล์
| การตั้งค่า | ประเภท | คำอธิบาย |
|---|---|---|
| คีย์ API | ข้อมูลรับรองของบัญชี | บัญชีที่ยอดคงเหลือจะถูกใช้สำหรับงานที่เลือก |
| ไฟล์และชีต | การเลือกไฟล์ | เลือกไฟล์ที่ยอมรับ 1 ไฟล์และชีตที่ถูกต้อง |
| วิธี | ตัวเลือก | name, email หรือ username ตรวจสอบค่าที่ระบบแนะนำโดยอัตโนมัติ |
| คอลัมน์ต้นทาง | การจับคู่คอลัมน์ | ข้อมูลนำเข้าที่จะวิเคราะห์ในแต่ละแถว ตรวจสอบส่วนหัวและค่าตัวอย่าง |
| บริบทประเทศ | คอลัมน์หรือการตั้งค่าที่ไม่บังคับ | ใช้รหัสประเทศ 2 ตัวอักษรที่ทราบอยู่แล้วเมื่อเกี่ยวข้อง |
| ตัวเลือก AI และการส่งออก | ตัวควบคุมปัจจุบันของเครื่องมือ | ตรวจสอบการตั้งค่าที่แสดงก่อนประมวลผล ตัวเลือกเหล่านี้ไม่ใช่พารามิเตอร์ ai_mode ของ V2 |
อ่านคอลัมน์ผลลัพธ์ของส่วนเสริม
ไฟล์ CSV ที่ส่งออกจะเพิ่มฟิลด์ผลลัพธ์ในตัว ได้แก่ gender, country, probability และ found_name ตรวจสอบว่าแถวตรงกับต้นฉบับและหัวคอลัมน์ถูกต้องก่อนนำเข้าไปยังระบบอื่น รูปแบบผลลัพธ์เป็น CSV แม้ว่าข้อมูลนำเข้าจะเป็นเวิร์กบุ๊ก Excel ก็ตาม
ผลการคาดการณ์เป็นความเชื่อมโยงที่ได้จากการคาดการณ์ แยกไว้ต่างหากจากเพศที่บุคคลระบุด้วยตนเองและข้อมูลประเทศที่ยืนยันแล้ว
- ตรวจดูผลลัพธ์ทั่วไป ข้อมูลนำเข้าที่กำกวม และงานที่ล้มเหลวอย่างละหนึ่งกรณีก่อนประมวลผลทั้งชุดข้อมูล
- เซลล์ว่าง ข้อความ null และข้อผิดพลาดของสูตรเป็นค่าที่ต่างกันในสเปรดชีต ปรับผลลัพธ์ unknown ให้เป็นรูปแบบเดียวกันอย่างตั้งใจโดยไม่ซ่อนข้อผิดพลาด
- ใช้การจัดการสำรองที่เป็นกลางสำหรับเรคคอร์ดที่ไม่ทราบหรือไม่แน่นอน เก็บข้อมูลโปรไฟล์ที่บุคคลให้ไว้แยกจากคอลัมน์ที่ได้จากการคาดการณ์
| ผลลัพธ์ | ชนิดโดยทั่วไป | วิธีใช้ |
|---|---|---|
| Gender | ข้อความหรือค่าที่ยังระบุไม่ได้ | คงค่า male หรือ female ไว้เฉพาะผลลัพธ์ที่สำเร็จ เก็บค่าที่ยังระบุไม่ได้เป็น unknown และตรวจสอบข้อความข้อผิดพลาดแยกต่างหาก |
| Probability | ตัวเลข (เมื่อมี) | สัญญาณความเชื่อมั่นแบบเดิม ไม่ใช่ฟิลด์ confidence ของ V2 และไม่ใช่อัตราความแม่นยำที่วัดจากชุดข้อมูลของคุณ |
| Country | ข้อความ (เมื่อมี) | บริบทที่ส่งคืนจากการค้นหา เก็บแยกจากประเทศของลูกค้าที่ได้รับการยืนยัน |
| Found / normalized name | ข้อความ (เมื่อมี) | ชื่อที่ใช้หรือแยกออกมาระหว่างการประมวลผล ตรวจสอบค่านี้เมื่ออีเมลหรือชื่อผู้ใช้กำกวม |
วางแผนเรื่องเครดิต ขีดจำกัด และการเรียกใช้ซ้ำ
บัญชี GenderAPI แบบฟรีที่ลงทะเบียนแล้วมีเครดิตวันละ 200 เครดิต เครดิตคือยอดคงเหลือของบัญชี ไม่ได้รับประกันผลลัพธ์ที่สำเร็จ 200 รายการในทุกเวิร์กโฟลว์ ตรวจสอบยอดคงเหลือของคีย์ที่เลือกและตัวเลือกการประมวลผลปัจจุบันของเครื่องมือก่อนเริ่ม
ส่วนเสริมในตัวและงานไฟล์มีเส้นทางการประมวลผลของตนเอง ขีดจำกัดคำขอแบบกลุ่ม ตัวเลือก AI และฟิลด์การหักเครดิตรายคำขอของ REST API V2 ไม่ได้มีผลกับส่วนเหล่านี้โดยอัตโนมัติ การเรียกใช้ซ้ำหรือการคำนวณใหม่อาจส่งงานใหม่ได้ จึงไม่ควรถือว่าไม่มีค่าใช้จ่าย
เริ่มจากตัวอย่างขนาดเล็ก เก็บผลลัพธ์ที่เสร็จแล้ว และตรวจสอบแถวที่ล้มเหลวก่อนเรียกใช้ซ้ำ หากต้องแก้ไขเพียงการส่งออกหรือการอัปเดตแอปปลายทางในภายหลัง ให้ใช้ผลลัพธ์ที่มีอยู่แล้วซ้ำ
คำนึงถึงการวิเคราะห์ในขั้นตั้งค่าและการเก็บรักษาไฟล์
เมื่อเลือกชีต ระบบอาจส่งเซลล์ตัวอย่างเพื่อให้ AI ช่วยจับคู่คอลัมน์ก่อนขั้นตอนการประมวลผลสุดท้าย อย่าสันนิษฐานว่าข้อมูลทั้งหมดจะอยู่ในเครื่องของคุณจนกว่าจะกดปุ่ม Start ลบคอลัมน์ที่ไม่จำเป็นออก และอ่านนโยบายความเป็นส่วนตัวก่อนเลือกไฟล์ที่มีข้อมูลส่วนบุคคล
หลังส่งออกแล้ว หากไม่ต้องการสำเนาในพื้นที่ทำงานอีกต่อไป ให้ใช้ฟังก์ชันลบที่มีให้ นโยบายที่เผยแพร่อธิบายการลบตามกำหนดเวลาจากระบบที่ใช้งานอยู่และการเก็บรักษาในข้อมูลสำรอง การมีกำหนดการลบไม่ได้เป็นหลักฐานว่าสำเนาทั้งหมดถูกลบไปแล้ว
เมื่อใดควรใช้ API V2 โดยตรง
หากแอปพลิเคชันต้องใช้ตัวเลือก AI ที่ระบุชัดเจน และข้อมูล status, source, confidence_kind และ usage รายรายการจาก V2 ให้ใช้การเชื่อมต่อ HTTP แยกต่างหาก ทำตามข้อกำหนดคำขอและการตอบกลับของ V2 การเพิ่มชื่อฟิลด์ของ V2 ลงในสูตรในตัวหรือส่วนเสริมที่มีอยู่ไม่ได้เปลี่ยนการทำงานของไคลเอนต์นั้น
คำถามที่พบบ่อย
ใช้ไฟล์ XLSM ในการอัปโหลดได้หรือไม่?
ตัวเลือกอัปโหลดในปัจจุบันแสดง CSV, XLS, XLSX, Numbers, ODS, TSV และ TXT ให้ส่งออกเวิร์กบุ๊ก XLSM เป็นรูปแบบใดรูปแบบหนึ่งเหล่านี้ และตรวจสอบค่าที่แปลงแล้วก่อนอัปโหลด
คำแนะนำคอลัมน์ถูกต้องเสมอหรือไม่?
ไม่ ตรวจสอบประเภทข้อมูลนำเข้าที่แนะนำ การจัดการแถวส่วนหัว คอลัมน์ต้นทาง และการจับคู่ประเทศ ระหว่างการตั้งค่าอาจมีการส่งข้อมูลตัวอย่างเพื่อให้ AI ช่วยแนะนำ
จะได้รับเวิร์กบุ๊ก Excel ต้นฉบับกลับมาหรือไม่?
งานไฟล์ตามเอกสารส่งออกผลลัพธ์เป็น CSV ตรวจสอบคอลัมน์ที่ส่งออกและความตรงกันของแถวก่อนนำเข้าไปยังเวิร์กบุ๊กต้นฉบับหรือเครื่องมืออื่น
เป็นสิ่งเดียวกับคำขอแบบกลุ่มของ V2 หรือไม่?
ไม่ใช่ นี่เป็นงานไฟล์ในแดชบอร์ดที่มีตัวเลือกและวิธีประมวลผลของตัวเอง เมื่อสร้างคำขอ JSON ในการเชื่อมต่อที่คุณพัฒนาเอง ให้ดูเอกสารคำขอแบบกลุ่มของ V2
แหล่งที่มาและเอกสาร
คู่มือนี้ตรวจทานล่าสุดเมื่อ ตรวจสอบวิธีติดตั้งได้ในเอกสารของแต่ละแพลตฟอร์ม และใช้เอกสาร API ด้านล่างเมื่อสร้างการเชื่อมต่อ V2 แยกต่างหาก