GradeView คู่มือการติดตั้ง
⏱ ติดตั้งประมาณ 10 นาที · ไม่ต้องเขียนโค้ด

ติดตั้ง GradeView แดชบอร์ดผลการเรียน

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

👤บัญชี GoogleGmail หรือ Google Workspace
💻คอมพิวเตอร์ใช้ตอนติดตั้งครั้งแรก
📄3 ไฟล์Code.gs · Index.html · appsscript.json
📱เปิดดูได้ทุกที่คอม แท็บเล็ต มือถือ
📑 สารบัญ
ส่วนที่ 1

ติดตั้งบน Google

ทำครั้งเดียวบนคอมพิวเตอร์ ประมาณ 10 นาที

1

เริ่มต้น

สร้างไฟล์ Google Sheets ใหม่

ไฟล์นี้คือ “ฐานข้อมูล” ของแดชบอร์ด เก็บรายชื่อนักเรียน รายวิชาพร้อมหน่วยกิต และคะแนนทุกภาคเรียน

  1. เข้า sheets.new (ล็อกอินบัญชี Google ที่จะใช้เป็นเจ้าของข้อมูล)
  2. คลิกชื่อไฟล์มุมซ้ายบน ตั้งชื่อ เช่น GradeView ผลการเรียน
💡 ใช้บัญชีไหนติดตั้ง บัญชีนั้นเป็นเจ้าของข้อมูล

รายงานอีเมลจะส่งจากบัญชีนี้ และข้อมูลทั้งหมดอยู่ใน Drive ของบัญชีนี้ — กิจการควรใช้บัญชีกลางของร้าน/องค์กร ไม่ใช่บัญชีส่วนตัวของพนักงาน

2

ใส่ระบบ

วางไฟล์ Code.gs · Index.html · appsscript.json

ชุดไฟล์ที่ได้รับมี 3 ไฟล์หลักที่ต้องวางใน Apps Script

GS
Code.gsโค้ดฝั่งเซิร์ฟเวอร์ทั้งหมด
HTML
Index.htmlหน้าแดชบอร์ด (ไฟล์ชื่อ Index)
JSON
appsscript.jsonเขตเวลาและสิทธิ์
  1. ในไฟล์ชีต ไปที่เมนู ส่วนขยาย›Apps Script
  2. คลิกชื่อโปรเจกต์มุมซ้ายบน (“โปรเจกต์ที่ไม่มีชื่อ”) เปลี่ยนเป็น GradeView แดชบอร์ดผลการเรียน — ชื่อนี้จะแสดงในหน้าขออนุญาตสิทธิ์
  3. เปิดไฟล์ Code.gs กด Ctrl + A ลบโค้ดเดิม แล้ววางเนื้อหาไฟล์ Code.gs ที่ได้รับทั้งไฟล์
  4. กดปุ่ม + ข้างคำว่า “ไฟล์” › HTML ตั้งชื่อว่า Index (ตัว I ใหญ่ ไม่ต้องพิมพ์ .html) ลบเนื้อหาเดิม แล้ววางไฟล์ Index.html ทั้งไฟล์
  5. ไปที่ ⚙ การตั้งค่าโปรเจกต์ ติ๊ก “แสดงไฟล์ Manifest ‘appsscript.json’ ในเครื่องมือแก้ไข” กลับมาเปิดไฟล์ appsscript.json แล้ววางทับทั้งไฟล์
  6. กด Ctrl + S บันทึกทุกไฟล์
⚠ ชื่อไฟล์ HTML ต้องเป็น Index

ถ้าตั้งชื่ออื่น (เช่น index ตัวเล็ก หรือ Index.html.html) หน้าเว็บจะเปิดไม่ขึ้นและแจ้งว่าไม่พบไฟล์ HTML

✓ appsscript.json ทำอะไร

ตั้งเขตเวลา Asia/Bangkok ให้ยอดรายวันและเวลาส่งรายงานตรงกับเวลาไทย และระบุสิทธิ์ที่ระบบขอให้ชัดเจน

3

ติดตั้ง

รันฟังก์ชัน setup เพื่อสร้างชีตและข้อมูลตัวอย่าง

  1. ในหน้า Apps Script เปิดไฟล์ Code.gs แล้วเลือกฟังก์ชัน setup จากช่องรายชื่อฟังก์ชันบนแถบเครื่องมือ
  2. กด ▷ เรียกใช้ — ครั้งแรก Google จะขออนุญาตสิทธิ์ ทำตามขั้นตอนที่ 4
  3. รอ 10–40 วินาที ดู บันทึกการดำเนินการ ด้านล่างจะขึ้นข้อความ “ติดตั้ง GradeView แดชบอร์ดผลการเรียน เรียบร้อย…”
  4. กลับไปที่แท็บ Google Sheets จะเห็นชีต คะแนน · นักเรียน · รายวิชา พร้อมข้อมูลตัวอย่าง และเมนู 📊 GradeView บนแถบเมนู (ถ้ายังไม่เห็นให้รีเฟรชหน้า)
รันซ้ำได้อย่างปลอดภัย

setup สร้างเฉพาะชีตที่ขาดและจัดหัวตารางใหม่ ไม่ลบข้อมูลเดิม และใส่ข้อมูลตัวอย่างเฉพาะชีตที่ยังว่าง — ใช้ซ่อมกรณีเผลอลบชีตได้

4

ครั้งเดียว

อนุญาตสิทธิ์ให้สคริปต์

  1. หน้าต่าง “ต้องมีการให้สิทธิ์” กด ตรวจสอบสิทธิ์ แล้วเลือกบัญชี Google ของคุณ
  2. ถ้าขึ้น “Google ไม่ได้ยืนยันแอปนี้” กด ขั้นสูง (Advanced) › ไปที่ GradeView แดชบอร์ดผลการเรียน (ไม่ปลอดภัย) — เป็นปกติของสคริปต์ที่ติดตั้งเองในบัญชีของคุณ
  3. ตรวจรายการสิทธิ์แล้วกด อนุญาต (ถ้ามีช่องติ๊กให้เลือกทั้งหมด)
หน้าเตือน “Google ไม่ได้ยืนยันแอปนี้” — กด ขั้นสูง แล้วเลือกไปที่โปรเจกต์ของคุณ
หน้าเตือน “Google ไม่ได้ยืนยันแอปนี้” — กด ขั้นสูง แล้วเลือกไปที่โปรเจกต์ของคุณ
หน้ารายการสิทธิ์ — เลื่อนลงแล้วกด อนุญาต
หน้ารายการสิทธิ์ — เลื่อนลงแล้วกด อนุญาต
สิทธิ์ที่ขอใช้ทำอะไร
ดู แก้ไข สร้าง และลบสเปรดชีตอ่านข้อมูลมาแสดงบนแดชบอร์ด และบันทึกรายการที่กรอกจากหน้าเว็บลงชีตของคุณ
ส่งอีเมลในนามคุณส่งรายงานสรุป/แจ้งเตือนไปยังอีเมลที่คุณตั้งไว้เท่านั้น
เรียกใช้เมื่อคุณไม่ได้อยู่ทริกเกอร์ตามเวลาสำหรับส่งรายงานอัตโนมัติ
แสดงเนื้อหาในแอปพลิเคชันของ Googleเมนู 📊 GradeView ในไฟล์ชีต
ดูอีเมลของคุณตั้งเป็นอีเมลผู้รับรายงานเริ่มต้น

หลังอนุญาตแล้ว ถ้า setup ยังไม่ทำงาน ให้กด ▷ เรียกใช้ อีกครั้ง

5

ออนไลน์

เผยแพร่เป็นเว็บแอป (Deploy)

  1. มุมขวาบนของ Apps Script กด การทำให้ใช้งานได้›การทำให้ใช้งานได้รายการใหม่
  2. กดไอคอนฟันเฟือง ⚙ ข้าง “เลือกประเภท” แล้วเลือก เว็บแอป
  3. ตั้งค่า ดำเนินการในฐานะ: ฉัน และ ผู้มีสิทธิ์เข้าถึง: ทุกคน แล้วกด การทำให้ใช้งานได้
  4. คัดลอก URL ของเว็บแอป (ลงท้ายด้วย /exec) เก็บไว้ — นี่คือลิงก์แดชบอร์ดของคุณ
เมนู การทำให้ใช้งานได้ › การทำให้ใช้งานได้รายการใหม่
เมนู การทำให้ใช้งานได้ › การทำให้ใช้งานได้รายการใหม่
เลือกประเภท เว็บแอป
เลือกประเภท เว็บแอป
ดำเนินการในฐานะ ฉัน · ผู้มีสิทธิ์เข้าถึง ทุกคน แล้วกด การทำให้ใช้งานได้
ดำเนินการในฐานะ ฉัน · ผู้มีสิทธิ์เข้าถึง ทุกคน แล้วกด การทำให้ใช้งานได้
คัดลอก URL เว็บแอป (ในภาพเบลอไว้) แล้วกด เสร็จสิ้น
คัดลอก URL เว็บแอป (ในภาพเบลอไว้) แล้วกด เสร็จสิ้น
ทำไมเลือก “ทุกคน” ถึงยังปลอดภัย

ทุกคนที่มีลิงก์จะเห็นแค่หน้าใส่ PIN — ข้อมูลจะโหลดหลังใส่ PIN ถูกเท่านั้น ส่วนไฟล์ชีตยังเป็นส่วนตัวของคุณ · องค์กรที่ใช้ Google Workspace เลือก “ทุกคนใน [โดเมน]” เพื่อจำกัดเฉพาะบัญชีในองค์กรได้

6

พร้อมใช้

เปิดแดชบอร์ดครั้งแรกและเปลี่ยน PIN

  1. เปิด URL เว็บแอป ใส่ PIN เริ่มต้น
PIN เริ่มต้น: 1234
  1. ไปที่เมนู ตั้งค่า › เปลี่ยน PIN เข้าใช้งาน ตั้ง PIN ใหม่ 4–8 หลัก
  2. แก้ ชื่อโรงเรียน และตั้งค่าเฉพาะของระบบ แล้วกดบันทึก
  3. ตั้ง ส่งรายงานสรุปอัตโนมัติ (รอบ เวลา อีเมลผู้รับ แนบ PDF) — ดูรายละเอียดในคู่มือการใช้งาน
  4. บนมือถือ เปิดลิงก์ใน Chrome/Safari แล้วเลือก เพิ่มไปยังหน้าจอหลัก เพื่อเปิดเหมือนแอป
หน้า ภาพรวมผลการเรียน ภาคเรียนที่ 1/2569 — GPA เฉลี่ย ผ่านทุกวิชา กลุ่มเฝ้าระวัง คะแนนเฉลี่ยรายวิชา และการกระจายเกรด
หน้า ภาพรวมผลการเรียน ภาคเรียนที่ 1/2569 — GPA เฉลี่ย ผ่านทุกวิชา กลุ่มเฝ้าระวัง คะแนนเฉลี่ยรายวิชา และการกระจายเกรด
7

ภายหลัง

อัปเดตเวอร์ชันใหม่โดยใช้ URL เดิม

  1. วางไฟล์ Code.gs / Index.html เวอร์ชันใหม่ทับของเดิม แล้วบันทึก
  2. กด การทำให้ใช้งานได้›จัดการการทำให้ใช้งานได้ › ไอคอนดินสอ ✏️ › ช่อง เวอร์ชัน เลือก เวอร์ชันใหม่ › การทำให้ใช้งานได้
  3. ถ้าเวอร์ชันใหม่เพิ่มชีต ให้รัน setup อีกครั้ง (ข้อมูลเดิมไม่หาย)
⚠ อย่าสร้าง “การทำให้ใช้งานได้รายการใหม่” ซ้ำ

จะได้ URL ใหม่ ต้องแจ้งลิงก์ใหม่กับทุกคน — ใช้ “จัดการการทำให้ใช้งานได้” เพื่อคง URL เดิม

ส่วนที่ 2

ข้อมูลในชีต

แดชบอร์ดอ่านข้อมูลจากชีตเหล่านี้โดยตรง

📋

โครงสร้าง

ชีตที่ระบบสร้างให้

ระบบอ่านตามลำดับคอลัมน์ เปลี่ยนชื่อหัวตารางได้แต่อย่าสลับลำดับ หรือแทรกคอลัมน์ตรงกลาง (เพิ่มคอลัมน์ของคุณเองทางขวาสุดได้) · วันที่พิมพ์ได้ทั้งแบบวันที่ของ Sheets, 25/09/2026, 2026-09-25 หรือปี พ.ศ. 25/09/2569

ชีต “คะแนน”

คอลัมน์หัวตารางคำอธิบาย
Aภาคเรียน (ปี/ภาค)ปีการศึกษา พ.ศ./ภาค เช่น 2569/1
Bชั้น/ห้องห้องที่เรียนในภาคนั้น เช่น ม.2/1
Cเลขประจำตัว
Dรหัสวิชาตรงกับชีต รายวิชา
Eคะแนนเก็บ (70)
Fคะแนนสอบ (30)เว้นว่าง = ร (ไม่มีผลสอบ)
Gเวลาเรียน (%)ต่ำกว่าเกณฑ์ (เริ่มต้น 80%) = มส
Hหมายเหตุ

ชีต “นักเรียน”

คอลัมน์หัวตารางคำอธิบาย
Aเลขประจำตัวห้ามซ้ำ
Bคำนำหน้า
Cชื่อ
Dนามสกุล
Eเพศชาย / หญิง
Fชั้น/ห้องปัจจุบัน
Gเลขที่
Hสถานะกำลังศึกษา / ย้ายออก / จบการศึกษา

ชีต “รายวิชา”

คอลัมน์หัวตารางคำอธิบาย
Aรหัสวิชา
Bชื่อวิชา
Cกลุ่มสาระการเรียนรู้
Dหน่วยกิต
Eระดับชั้นเช่น ม.1
🚀

เริ่มใช้จริง

ล้างข้อมูลตัวอย่างแล้วใส่ข้อมูลของคุณ

  1. ลองใช้งานกับข้อมูลตัวอย่างจนคุ้นเคย
  2. ในไฟล์ชีต เลือกเมนู 📊 GradeView›ล้างข้อมูลตัวอย่าง (เริ่มใช้งานจริง) แล้วกด ใช่ — ลบเฉพาะแถวข้อมูล หัวตารางยังอยู่
  3. แทนชีต นักเรียน ด้วยรายชื่อจริง (ส่งออกจากระบบทะเบียนได้) และปรับชีต รายวิชา ให้ตรงหลักสูตรสถานศึกษา (สองชีตนี้ไม่ถูกล้าง) · ให้ครูกรอกคะแนนที่หน้า บันทึกคะแนน หรือวางคะแนนลงชีต คะแนน
💡 ย้ายข้อมูลจากไฟล์เดิม

ถ้าครูเก็บคะแนนใน Excel/ปพ.5 อยู่แล้ว ให้จัดคอลัมน์ตามชีต คะแนน (ภาคเรียน 2569/1 · ชั้น/ห้อง · เลขประจำตัว · รหัสวิชา · คะแนนเก็บ · คะแนนสอบ · เวลาเรียน %) แล้ววางต่อท้าย — หนึ่งแถวต่อนักเรียนหนึ่งคนต่อหนึ่งวิชา

ช่วยเหลือ

คำถามที่พบบ่อย

เปิดเว็บแอปแล้วขึ้น “ยังไม่ได้ติดตั้งระบบ”

ยังไม่ได้รันฟังก์ชัน setup ในหน้า Apps Script — กลับไปทำขั้นตอนที่ 3 ของคู่มือติดตั้ง แล้วรีเฟรชหน้าเว็บแอป

ลืม PIN ทำอย่างไร

เปิดไฟล์ Google Sheets แล้วเลือกเมนู 📊 GradeView›รีเซ็ต PIN เป็น 1234 จากนั้นเข้าเว็บแอปด้วย 1234 แล้วตั้ง PIN ใหม่ที่หน้า ตั้งค่า (เฉพาะเจ้าของไฟล์ชีตเท่านั้นที่ทำได้)

แก้โค้ดหรืออัปเดตเวอร์ชันแล้ว แต่หน้าเว็บยังเป็นแบบเดิม

ต้องสร้างเวอร์ชันใหม่ของการทำให้ใช้งานได้ ดูขั้นตอนที่ 7 ของคู่มือติดตั้ง — URL เดิมจะใช้ได้ต่อ ไม่ต้องแจ้งลิงก์ใหม่

ไม่ได้รับอีเมลรายงาน

ตรวจว่าเปิดสวิตช์ส่งรายงานและใส่อีเมลถูกต้องที่หน้า ตั้งค่า · ลองกด ส่งอีเมลตอนนี้ ในหน้าต่างรายงาน · ดูโฟลเดอร์จดหมายขยะ · บัญชี Gmail ทั่วไปส่งอีเมลจากสคริปต์ได้ประมาณ 100 ฉบับต่อวัน (ระบบแสดงโควตาคงเหลือในหน้าตั้งค่า)

คนอื่นในทีมเปิดดูได้ไหม

ได้ ส่ง URL เว็บแอปพร้อม PIN ให้ทีม ผู้ดูไม่ต้องมีสิทธิ์แก้ไขไฟล์ชีต (ระบบทำงานในนามเจ้าของไฟล์) · ถ้าต้องการจำกัดเฉพาะบัญชีในองค์กร ให้เลือก “ผู้มีสิทธิ์เข้าถึง” เป็นบัญชีในโดเมนของคุณตอน Deploy

ข้อมูลเยอะขึ้นเรื่อย ๆ จะช้าไหม

ระบบออกแบบสำหรับข้อมูลระดับหลักหมื่นแถวได้สบาย (ข้อมูลตัวอย่างประมาณหนึ่งหมื่นแถวโหลดในไม่กี่วินาที) ถ้าเกินหลักแสนแถว แนะนำย้ายข้อมูลปีเก่าไปเก็บอีกไฟล์ แล้วเหลือเฉพาะ 1–2 ปีล่าสุดไว้ในไฟล์ที่ใช้งาน

ข้อมูลปลอดภัยไหม

ข้อมูลทั้งหมดอยู่ในไฟล์ Google Sheets ใน Drive ของคุณ ไม่มีการส่งออกไปเซิร์ฟเวอร์ภายนอก · PIN เก็บเป็นค่าแฮช · ทุกการเรียกข้อมูลต้องผ่าน PIN (เซสชันหมดอายุใน 6 ชั่วโมง) · ใส่ PIN ผิด 8 ครั้งระบบล็อก 10 นาที

ใช้กับระดับประถมได้ไหม

ได้ ใส่ชั้น/ห้องเป็น ป.1/1 … ป.6/2 และรหัสวิชาตามหลักสูตรประถม (หน่วยกิตใช้เป็นน้ำหนักเวลาเรียนได้) ระบบรองรับ อ. ป. และ ม.

สัดส่วนคะแนนไม่ใช่ 70:30

คะแนนรวมเต็ม 100 เสมอ ถ้าโรงเรียนใช้ 80:20 ให้กรอกคะแนนเก็บเต็ม 80 ในชีตได้โดยตรง (หน้าบันทึกคะแนนจำกัดเก็บ 70 / สอบ 30 ตามเกณฑ์ทั่วไป)

นักเรียนย้ายห้องระหว่างปี

ชีตคะแนนเก็บ ชั้น/ห้อง ของแต่ละภาคเรียนไว้ ผลย้อนหลังจึงไม่เปลี่ยน แก้ ชั้น/ห้องปัจจุบัน ในชีตนักเรียนเพื่อให้ปรากฏในใบกรอกคะแนนห้องใหม่