# ใช้สูตร GENDER ใน Google Sheets

> ใช้ =GENDER วิเคราะห์ชื่อ อีเมล และชื่อผู้ใช้ใน Google Sheets ดูลำดับอาร์กิวเมนต์ บริบทประเทศ ผลลัพธ์แบบขยาย การคำนวณใหม่ และคำแนะนำเรื่องโควตา

Canonical HTML: https://www.genderapi.io/th/blog/gender-formula-google-sheets-detect-gender-from-names

Last reviewed: 2026-09-30

## คำนวณผลลัพธ์จากเซลล์เดียว

หลังจากติดตั้งส่วนเสริม GenderAPI สำหรับ Google Sheets และบันทึกคีย์ในการตั้งค่า Formula แล้ว ให้ป้อน =GENDER(A2) เพื่อวิเคราะห์ชื่อใน A2 อาร์กิวเมนต์ที่ไม่บังคับใช้เลือกข้อมูลนำเข้าแบบอีเมลหรือชื่อผู้ใช้ บริบทประเทศ และคอลัมน์ผลลัพธ์เพิ่มเติม

GENDER เป็นสูตรในตัวของส่วนเสริม ไม่รับออบเจ็กต์คำขอ JSON ของ V2 และไม่ส่งคืนโครงสร้างการตอบกลับของ V2

- [ติดตั้งส่วนเสริมที่จำเป็น](https://workspace.google.com/marketplace/app/gender_api_for_google_sheets_determines/712811575775)
- [ใช้แถบด้านข้างสำหรับช่วงแถวที่ใหญ่ขึ้น](https://www.genderapi.io/th/blog/how-to-determine-gender-in-google-sheets-using-gender-api-add-on)

## บันทึกคีย์ก่อนป้อนสูตร

- เปิด Extensions (ส่วนขยาย) → GenderAPI → Determine Gender แล้วใช้เมนูในแถบด้านข้างเพื่อเปิดหน้า Formula
- เลือกคีย์ API ที่บันทึกไว้ หรือป้อนคีย์แล้วบันทึก เก็บข้อมูลรับรองไว้ในแถบด้านข้าง ไม่ใช่ในเซลล์ของชีตที่แชร์
- ใส่ข้อมูลนำเข้าที่เป็นตัวแทนใน A2 และป้อนสูตรในเซลล์อื่น เว้นพื้นที่ทางขวาไว้เมื่อขอข้อมูลเพิ่มเติม
- ตรวจสอบผลลัพธ์และวิธีใช้สูตรปัจจุบันในแถบด้านข้างก่อนเติมสูตรลงไปยังแถวอื่น

## อาร์กิวเมนต์เรียงตามลำดับนี้

| อาร์กิวเมนต์ | ชนิด | ค่าเริ่มต้น | คำอธิบาย |
| --- | --- | --- | --- |
| `input` | ข้อความหรือการอ้างอิงเซลล์ | จำเป็น | ค่าชื่อ อีเมล หรือชื่อผู้ใช้ เช่น A2 |
| `method` | ข้อความ | name | ใช้ name, email หรือ username ให้ตรงกับข้อมูลนำเข้า |
| `country_filter` | ข้อความ | ไม่มีตัวกรองประเทศ | รหัสประเทศ 2 ตัวอักษรที่ไม่บังคับ ใช้สตริงว่างเมื่อข้ามอาร์กิวเมนต์นี้ก่อน additional_info |
| `additional_info` | บูลีน | FALSE | TRUE จะขอฟิลด์เพิ่มเติมในคอลัมน์ที่อยู่ติดกัน ส่วน FALSE จะส่งคืนเฉพาะค่าเพศ |

**ตัวอย่างสูตร Google Sheets**

แต่ละบรรทัดเป็นสูตรแยกกัน เลือกรูปแบบที่ตรงกับค่าใน A2 ตัวอย่างแสดงเพียงไวยากรณ์และไม่รับประกันผลลัพธ์ใดโดยเฉพาะ ตัวคั่นอาร์กิวเมนต์อาจเป็นเครื่องหมายอัฒภาคแทนจุลภาค ขึ้นอยู่กับการตั้งค่าภูมิภาคของสเปรดชีต

```text
=GENDER(A2)
=GENDER(A2, "email")
=GENDER(A2, "username")
=GENDER(A2, "name", "IT", TRUE)
=GENDER(A2, "email", "", TRUE)
```

## เว้นพื้นที่สำหรับผลลัพธ์แบบขยาย

เมื่อเปิดใช้ additional_info วิธีใช้ปัจจุบันในแถบด้านข้างของ Google Sheets จะแสดง 4 ค่าตามลำดับนี้ ได้แก่ เพศ ประเทศ probability และชื่อที่ปรับรูปแบบแล้ว ซึ่งต่างจากลำดับของสูตรใน Excel ตรวจสอบวิธีใช้ของส่วนเสริมที่ติดตั้งไว้เมื่อสร้างหัวคอลัมน์

เว้นเซลล์ปลายทางทั้งหมดให้ว่างเพื่อให้อาร์เรย์ขยายได้ อาร์เรย์ที่ถูกบล็อก คีย์ที่หายไป หรือข้อผิดพลาดของแพลตฟอร์มเป็นปัญหาที่ต้องแก้ไข ไม่ใช่การคาดการณ์ว่าเพศไม่ทราบ

| ตำแหน่ง | วิธีใช้ปัจจุบันของ Sheets | วิธีจัดการ |
| --- | --- | --- |
| 1 | Gender | คงผลลัพธ์ที่ยังระบุไม่ได้เป็น unknown และแยกออกจากข้อความข้อผิดพลาด |
| 2 | Country | ใช้เป็นบริบทที่ส่งคืนจากการค้นหา ไม่ใช่ตำแหน่งที่ได้รับการยืนยัน |
| 3 | Probability | เก็บสัญญาณแบบเดิมนี้ไว้พร้อมผลลัพธ์ อย่าเปลี่ยนชื่อเป็น confidence ของ V2 |
| 4 | Normalized name | ตรวจสอบชื่อที่ได้จากข้อมูลนำเข้าก่อนนำไปใช้ในขั้นตอนถัดไป |

## ทำความเข้าใจการคำนวณใหม่และโน้ตที่แคชไว้

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

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

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

- [การทำงานของฟังก์ชันที่กำหนดเองใน Google](https://developers.google.com/apps-script/guides/sheets/functions)
- [โควตาปัจจุบันของ Google Apps Script](https://developers.google.com/apps-script/guides/services/quotas)

## วางแผนเรื่องเครดิต ขีดจำกัด และการเรียกใช้ซ้ำ

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

ส่วนเสริมในตัวและงานไฟล์มีเส้นทางการประมวลผลของตนเอง ขีดจำกัดคำขอแบบกลุ่ม ตัวเลือก AI และฟิลด์การหักเครดิตรายคำขอของ REST API V2 ไม่ได้มีผลกับส่วนเหล่านี้โดยอัตโนมัติ การเรียกใช้ซ้ำหรือการคำนวณใหม่อาจส่งงานใหม่ได้ จึงไม่ควรถือว่าไม่มีค่าใช้จ่าย

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

- [แพ็กเกจบัญชีและเครดิต](https://www.genderapi.io/th/price)

## เมื่อใดควรใช้ API V2 โดยตรง

หากแอปพลิเคชันต้องใช้ตัวเลือก AI ที่ระบุชัดเจน และข้อมูล status, source, confidence_kind และ usage รายรายการจาก V2 ให้ใช้การเชื่อมต่อ HTTP แยกต่างหาก ทำตามข้อกำหนดคำขอและการตอบกลับของ V2 การเพิ่มชื่อฟิลด์ของ V2 ลงในสูตรในตัวหรือส่วนเสริมที่มีอยู่ไม่ได้เปลี่ยนการทำงานของไคลเอนต์นั้น

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

## สูตรชื่อ GENDER_API หรือไม่?

ไม่ใช่ เอกสารของส่วนเสริม Google Sheets ระบุเป็น =GENDER(input, method, country_filter, additional_info) ส่วน Microsoft Excel ใช้ชื่ออื่น ได้แก่ GENDER.FROM_NAME, GENDER.FROM_EMAIL และ GENDER.FROM_USERNAME

## ขอฟิลด์เพิ่มเติมโดยไม่ใช้ตัวกรองประเทศได้หรือไม่?

ได้ ให้อาร์กิวเมนต์ที่สามเป็นสตริงว่าง เช่น =GENDER(A2, "email", "", TRUE) จากนั้นฟิลด์เพิ่มเติมจะขยายไปยังเซลล์ที่อยู่ติดกัน

## โน้ตที่แคชไว้ทำให้การคำนวณใหม่ไม่มีค่าใช้จ่ายหรือไม่?

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

## ทุกคนที่แก้ไขสเปรดชีตได้รับสิทธิ์เข้าถึงโดยอัตโนมัติหรือไม่?

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

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

- [หน้ารายการอย่างเป็นทางการของส่วนเสริม Google Sheets](https://workspace.google.com/marketplace/app/gender_api_for_google_sheets_determines/712811575775)
- [ฟังก์ชันที่กำหนดเองใน Google Sheets](https://developers.google.com/apps-script/guides/sheets/functions)
- [โควตาและขีดจำกัดของ Google Apps Script](https://developers.google.com/apps-script/guides/services/quotas)
- [ราคาและเครดิตของ GenderAPI](https://www.genderapi.io/th/price)
- [นโยบายความเป็นส่วนตัวของ GenderAPI](https://www.genderapi.io/th/privacy-policy)
- [ข้อกำหนดคำขอ V2](https://www.genderapi.io/th/docs/v2/request-parameters)
