สร้างไฟล์ Google Sheets ใหม่
- เปิด sheets.new (หรือ Google Drive › ใหม่ › Google ชีต) ด้วยบัญชีที่ต้องการเก็บข้อมูล
- ตั้งชื่อไฟล์ที่มุมซ้ายบน เช่น PromptPay QR — รายรับร้าน
เคล็ดลับ: ไฟล์นี้คือ "ฐานข้อมูล" ของระบบ ห้ามลบ ย้ายไปโฟลเดอร์อื่นใน Drive ได้ตามสบาย
เปิด Apps Script จากไฟล์ชีต
- ในไฟล์ชีต กดเมนู ส่วนขยาย › Apps Script (ภาษาอังกฤษ: Extensions › Apps Script)
- แท็บใหม่จะเปิดหน้าแก้ไขโค้ด ซึ่งมีไฟล์
Code.gsว่าง ๆ อยู่ 1 ไฟล์ - ตั้งชื่อโปรเจกต์ที่มุมซ้ายบน (เช่น PromptPay QR) — ไม่บังคับ
สำคัญ: ต้องเปิด Apps Script จากเมนูของไฟล์ชีต เท่านั้น (ไม่ใช่สร้างจาก script.google.com) เพื่อให้โค้ดผูกกับไฟล์นี้
วางไฟล์ทั้ง 3 ไฟล์
ในโฟลเดอร์ที่ดาวน์โหลด มีไฟล์ที่ต้องใช้ดังนี้
3.1 วาง Code.gs
- เปิดไฟล์
Code.gsจากโฟลเดอร์ด้วย Notepad / VS Code แล้วกด Ctrl+A › Ctrl+C - กลับมาที่ Apps Script คลิกไฟล์
Code.gsกด Ctrl+A แล้ว Ctrl+V วางทับโค้ดเดิมทั้งหมด
3.2 สร้างไฟล์ Index.html
- กดปุ่ม ＋ ข้างคำว่า "ไฟล์" › เลือก HTML
- พิมพ์ชื่อ
Index(ตัว I ใหญ่ ไม่ต้องพิมพ์ .html) แล้วกด Enter - ลบโค้ดตัวอย่างในไฟล์ใหม่ทิ้ง แล้ววางเนื้อหาทั้งหมดจากไฟล์
Index.html
3.3 วาง appsscript.json
- กดไอคอนเฟือง การตั้งค่าโปรเจกต์ (Project Settings) ทางซ้าย
- ติ๊ก แสดงไฟล์ Manifest "appsscript.json" ในเครื่องมือแก้ไข
- กลับไปที่ เครื่องมือแก้ไข (ไอคอน <>) จะเห็นไฟล์
appsscript.jsonเปิดแล้ววางเนื้อหาจากไฟล์ในโฟลเดอร์ทับทั้งหมด - กด Ctrl+S หรือไอคอนแผ่นดิสก์เพื่อบันทึก
ตรวจสอบ: ด้านซ้ายต้องมี 3 ไฟล์ appsscript.json · Code.gs · Index.html ถ้าชื่อไฟล์ HTML ไม่ใช่ Index ตรงตัว หน้าเว็บจะเปิดไม่ขึ้น
รันฟังก์ชัน setup และอนุญาตสิทธิ์
- ที่แถบเครื่องมือด้านบน เลือกฟังก์ชัน
setupจากรายการ แล้วกด ▶ เรียกใช้ (Run) - ครั้งแรก Google จะขอสิทธิ์ กด ตรวจสอบสิทธิ์ (Review permissions)
- เลือกบัญชี Google ของคุณ (บัญชีเดียวกับเจ้าของไฟล์ชีต)
- จะพบหน้า "Google ยังไม่ได้ยืนยันแอปนี้" — เป็นเรื่องปกติของสคริปต์ที่คุณติดตั้งเอง กด ขั้นสูง แล้วกดลิงก์ ไปที่ PromptPay QR (ไม่ปลอดภัย) ด้านล่าง
- หน้าถัดไปแสดงรายการสิทธิ์ (ดู สิทธิ์ที่ขอ) ติ๊ก เลือกทั้งหมด แล้วกด ดำเนินการต่อ / อนุญาต
- รอจนบันทึกการดำเนินการขึ้นว่า การดำเนินการเสร็จสมบูรณ์ — ระบบสร้างชีต รายรับ พร้อมข้อมูลตัวอย่างร้านกาแฟ 45 วันให้ลองดูกราฟได้ทันที
ปลอดภัยไหม? โค้ดทั้งหมดอยู่ในโปรเจกต์ของคุณ เปิดอ่านได้ทุกบรรทัด และทำงานด้วยบัญชีของคุณเอง ไม่มีการส่งข้อมูลไปเซิร์ฟเวอร์อื่น
จด PIN ผู้ดูแล
ใน บันทึกการดำเนินการ (Execution log) ด้านล่างของหน้าจอ จะมีข้อความคล้ายนี้
จด PIN 6 หลักนี้ไว้ ใช้เข้าระบบครั้งแรก แล้วเปลี่ยนเป็น PIN ที่จำง่ายได้ที่หน้า ตั้งค่า
ไม่เห็น PIN? ถ้ารัน setup ซ้ำ ระบบจะไม่สร้าง PIN ใหม่ ให้เลือกฟังก์ชัน resetAdminPin แล้วกดเรียกใช้ PIN ใหม่จะขึ้นในบันทึกการดำเนินการ
เผยแพร่เป็นเว็บแอป
- กดปุ่มสีน้ำเงิน การทำให้ใช้งานได้ (Deploy) มุมขวาบน › การทำให้ใช้งานได้รายการใหม่
- กดไอคอนเฟืองข้าง "เลือกประเภท" แล้วเลือก เว็บแอป
- ตั้งค่า: ดำเนินการในฐานะ = ฉัน และ ผู้มีสิทธิ์เข้าถึง = ทุกคน แล้วกด การทำให้ใช้งานได้
ทำไมเลือก "ทุกคน": เพื่อให้เปิดบนมือถือ/แท็บเล็ตของร้านได้ทันทีโดยไม่ต้องล็อกอิน Google ระบบล็อกด้วย PIN อยู่แล้ว คนอื่นที่ได้ลิงก์ไปก็เข้าไม่ได้ (ถ้าต้องการเข้มงวดขึ้น เลือก "เฉพาะฉัน" ได้ แต่ต้องล็อกอิน Google บัญชีนี้ทุกครั้ง)
- คัดลอก URL ของเว็บแอป (ลงท้ายด้วย
/exec) แล้วกด เสร็จสิ้น
ตั้งค่าพร้อมเพย์ & ทดสอบก่อนใช้จริง
- วาง URL ในเบราว์เซอร์ (คอมหรือมือถือ) จะพบหน้าใส่ PIN
- ใส่ PIN จากขั้นตอนที่ 5 — ระบบจำการเข้าสู่ระบบในเครื่องนั้นไว้ 30 วัน
- ไปที่หน้า ตั้งค่า เลือกประเภท (เบอร์มือถือ / เลขบัตรประชาชน / เลขผู้เสียภาษี / e-Wallet) ใส่เลขพร้อมเพย์ของร้าน ชื่อร้าน และชื่อบัญชี
- สแกน QR ทดสอบ 1 บาท ที่ขึ้นในหน้าตั้งค่าด้วยแอปธนาคาร ต้องเห็นยอด 1.00 บาทและชื่อบัญชีของร้านถูกต้อง แล้วกด บันทึกการตั้งค่า
- แก้ ยอดที่ใช้บ่อย และ เมนูด่วน ให้ตรงกับเมนูของร้าน
- บนมือถือ: กดเมนูเบราว์เซอร์ › เพิ่มไปยังหน้าจอหลัก เพื่อเปิดได้เหมือนแอป
เริ่มใช้จริง: ข้อมูลตัวอย่างช่วยให้ลองเล่นได้ทันที เมื่อพร้อมใช้จริงให้ไปที่หน้า ตั้งค่า › ล้างรายการทั้งหมด (การตั้งค่ายังอยู่)
อัปเดตเป็นเวอร์ชันใหม่ (ลิงก์เดิม)
- วางโค้ด
Code.gsและIndex.htmlเวอร์ชันใหม่ทับของเดิม แล้วบันทึก (ข้อมูลในชีตไม่หาย) - กด การทำให้ใช้งานได้ › จัดการการทำให้ใช้งานได้ › ไอคอนดินสอ ✏️
- ช่อง เวอร์ชัน เลือก เวอร์ชันใหม่ แล้วกด การทำให้ใช้งานได้
อย่ากด "การทำให้ใช้งานได้รายการใหม่" ซ้ำ เพราะจะได้ลิงก์ใหม่
ลืม PIN / แก้ปัญหาที่พบบ่อย
ลืม PIN ผู้ดูแล
เปิด Apps Script › เลือกฟังก์ชัน resetAdminPin › กด เรียกใช้ › PIN ใหม่จะขึ้นในบันทึกการดำเนินการ (ทุกอุปกรณ์ต้องเข้าสู่ระบบใหม่)
เปิดลิงก์แล้วขึ้น "ไม่พบไฟล์ HTML ชื่อ Index"
ชื่อไฟล์ HTML ต้องเป็น Index ตรงตัวพิมพ์เล็ก-ใหญ่ เปลี่ยนชื่อแล้ว อัปเดตเวอร์ชัน
ขึ้น "ไม่พบชีต … กรุณารันฟังก์ชัน setup"
มีคนลบหรือเปลี่ยนชื่อชีต ให้รัน setup อีกครั้ง ระบบจะสร้างชีตที่หายไปให้ (ข้อมูลที่มีอยู่ไม่ถูกลบ)
แก้โค้ดแล้วหน้าเว็บไม่เปลี่ยน
ลิงก์ /exec ใช้เวอร์ชันที่ deploy ไว้ ต้อง อัปเดตเวอร์ชัน ทุกครั้งที่แก้โค้ด
เปิดบนมือถือแล้วขึ้นหน้าล็อกอิน Google หรือ "ไม่มีสิทธิ์"
ตรวจว่าตั้ง ผู้มีสิทธิ์เข้าถึง = ทุกคน (ดูขั้นตอนที่ 6) หากแก้ภายหลังต้องอัปเดตเวอร์ชัน
สแกนแล้วแอปธนาคารแจ้ง "QR ไม่ถูกต้อง" หรือชื่อบัญชีไม่ตรง
ตรวจเลขพร้อมเพย์ในหน้า ตั้งค่า ว่าตรงกับที่ผูกไว้กับธนาคาร และเลือกประเภทถูก (เบอร์มือถือ / เลข 13 หลัก / e-Wallet) แล้วสแกน QR ทดสอบ 1 บาทอีกครั้ง
สิทธิ์ที่ระบบขอ และเหตุผล
| สิทธิ์ | ใช้ทำอะไร |
|---|---|
| ดูและแก้ไขไฟล์ Google Sheets | อ่าน/เขียนข้อมูลในไฟล์ชีตของระบบ (ไฟล์ที่คุณติดตั้งเท่านั้นที่โค้ดเปิดใช้) |
| ดูอีเมลของคุณ | ใช้ตรวจว่าผู้ที่สั่ง setup / resetAdminPin คือเจ้าของสคริปต์จากหน้าแก้ไขโค้ดเท่านั้น (คนที่เปิดเว็บแอปเรียกฟังก์ชันเหล่านี้ไม่ได้) — ไม่มีการเก็บหรือส่งอีเมลไปที่ใด |
ระบบไม่ขอสิทธิ์อ่าน Gmail, Drive ทั้งหมด หรือรายชื่อติดต่อ และไม่มีการส่งข้อมูลออกไปภายนอกบัญชีของคุณ (ยกเว้นโหลดฟอนต์/ไอคอน/ไลบรารีกราฟจาก CDN สาธารณะ) · QR พร้อมเพย์สร้างในเบราว์เซอร์ด้วยโค้ดในไฟล์ Index.html ไม่ส่งยอดเงินหรือเลขพร้อมเพย์ไปบริการสร้าง QR ภายนอก