เวอร์ชัน 1.0 วันที่ 30 เม.ย. 2024
เกณฑ์ในหน้านี้จะใช้กับส่วนเสริมทั้งหมดของ Classroom ส่วนเสริมต้องเป็นไปตามรายการที่เกี่ยวข้องทั้งหมดเพื่อให้ได้รับอนุมัติให้แสดงใน Google Workspace Marketplace และส่วนเสริมที่ "ใช้ได้กับ Classroom"
คำสำคัญในเอกสารนี้ ซึ่งได้แก่ "ต้อง" "ต้องไม่" "จำเป็น" "จะ" "จะไม่" "ควร" "ไม่ควร" "แนะนำ" "อาจ" และ "ไม่บังคับ" ให้ตีความได้ตามที่อธิบายไว้ใน RFC 2119
ข้อกำหนด
| ID | ประเภท | ||
|---|---|---|---|
| 1.0 | ใบอนุญาตสำหรับผู้ใช้ปลายทาง (หากมี) | ||
| 1.1 | "ต้อง" แสดงข้อความที่เหมาะกับผู้ใช้เมื่อผู้ใช้ไม่มีใบอนุญาต ข้อความต้องระบุสาเหตุที่ส่วนเสริมนี้ใช้ไม่ได้อย่างชัดเจน และแนะนำแนวทางการดำเนินการเพื่อให้ผู้ใช้แก้ไขสถานการณ์ | ต้องระบุ | |
| 1.3 | ข้อมูลใน Google Workspace Marketplace ของส่วนเสริมต้องระบุรายละเอียดเกี่ยวกับข้อกำหนดการอนุญาตให้ใช้สิทธิที่อาจจำเป็นสำหรับการใช้ส่วนเสริม หากส่วนเสริมมีระดับแบบชำระเงิน ข้อมูลผลิตภัณฑ์ใน Marketplace ต้องมีลิงก์ไปยังหน้าเว็บที่ให้ข้อมูลเพิ่มเติมเกี่ยวกับราคาหรือวิธีติดต่อพนักงานขาย | ต้องระบุ | |
| 2.0 | การลงชื่อเข้าใช้ของผู้ใช้ปลายทาง | ||
| 2.1 | ผู้ใช้ครูต้องลงชื่อเข้าใช้ส่วนเสริมโดยใช้ SSO ของ Google หากมีการขอให้ผู้ใช้ที่เป็นนักเรียนลงชื่อเข้าใช้ส่วนเสริม ผู้ใช้ต้องลงชื่อเข้าใช้ด้วย SSO ของ Google |
ต้องระบุ | |
| 2.2 | ส่วนเสริมต้องใช้ SSO ของ Google เพื่อให้ผู้ใช้ลงชื่อเข้าใช้โดยอัตโนมัติในการเข้าชมครั้งต่อๆ ไปโดยไม่แสดงข้อความแจ้งการเข้าสู่ระบบ เมื่อคำแนะนำการเข้าสู่ระบบไม่ตรงกับผู้ใช้ที่ลงชื่อเข้าใช้อยู่ ส่วนเสริมต้องแจ้งให้ผู้ใช้ทราบด้วยปุ่มลงชื่อเข้าใช้และส่งการเข้าสู่ระบบ_hintไปยังไลบรารีการตรวจสอบสิทธิ์เพื่อกรองบัญชีที่ไม่ถูกต้องออก |
ต้องระบุ | |
| 2.7 | เมื่อผู้ใช้ Classroom ยังไม่ได้ลงชื่อเข้าใช้ส่วนเสริม (ตามที่ระบุโดยดูที่คำแนะนำการเข้าสู่ระบบ) ส่วนเสริมต้องแสดงปุ่ม "ลงชื่อเข้าใช้ด้วย Google" เพื่อให้ผู้ใช้ดำเนินการอย่างชัดแจ้งเพื่อเริ่มขั้นตอนการลงชื่อเข้าใช้ หมายเหตุ: ขั้นตอนนี้จำเป็นเพื่อให้เป็นไปตามหลักเกณฑ์การใช้แบรนด์ของ Google และยังช่วยหลีกเลี่ยงตัวบล็อกป๊อปอัปด้วย |
ต้องระบุ | |
| 2.8 | ส่วนเสริมควรแสดงผู้ใช้ที่ลงชื่อเข้าใช้อยู่ในขณะนี้ | แนะนำ | |
| 3.0 | ทั่วไป | ||
| 3.1 | ส่วนเสริมต้องเป็นไปตามหลักเกณฑ์การอนุมัติทั่วไปของ Google Workspace Marketplace | ต้องระบุ | |
| 3.2 | หากมีการเปิดตัวงานในแท็บหรือหน้าต่างใหม่จากเส้นทาง iframe งานนั้นต้องระบุข้อความที่ใช้ง่ายเพื่อกลับไปยัง Classroom | ต้องระบุ | |
| 3.3 | ผู้ใช้ต้องทำตามขั้นตอนให้เสร็จสิ้นโดยใช้เวิร์กโฟลว์ส่วนเสริมเท่านั้น โดยไม่เปลี่ยนไปใช้ขั้นตอนของ CourseWork หรือใช้ปุ่มแชร์ของ Classroom | ต้องระบุ | |
| 3.4 | ตัวเลือกการแปลเป็นภาษาท้องถิ่น: ภาษาควรขึ้นอยู่กับค่ากำหนดท้องถิ่นที่เบราว์เซอร์ตั้งค่าไว้ (หากมี) | แนะนำ | |
| 3.5 | หากส่วนเสริมกำหนด maxPoints ส่วนเสริมต้องตั้งค่าเป็น pointsEarned เมื่อนักเรียนส่งงานโดยใช้ข้อมูลเข้าสู่ระบบของครูที่จัดเก็บไว้ (แนะนำ) หรือเมื่อครูเปิดงานใน iframe การตรวจสอบงานของนักเรียน |
ต้องระบุ | |
| 3.9 | ส่วนเสริมควรเป็นไปตามหลักเกณฑ์ WCAG 2.1 ระดับ AA เกี่ยวกับการช่วยเหลือพิเศษ นักพัฒนาแอปส่วนเสริมจะรายงานด้วยตนเองว่าเป็นไปตามข้อกำหนดนี้ ณ เวลาที่ส่ง และส่วนเสริมจะยังคงเป็นไปตามการเปลี่ยนแปลงของส่วนเสริมในอนาคต | แนะนำ | |
| 3.10 | ข้อผิดพลาดใดๆ ที่ผู้ใช้พบต้องสามารถอ่านได้ | ต้องระบุ | |
| 3.11 | หากมีการเปิด studentViewUri, teacherViewUri หรือ studentWorkViewUri จากงานที่คัดลอกหรือหลักสูตรที่คัดลอก ส่วนเสริมต้องไม่แสดงหน้าข้อผิดพลาดใน iframe |
ต้องระบุ | |
| 3.12 | หากมีการเปิด studentViewUri, teacherViewUri หรือ studentWorkViewUri จากงานที่คัดลอกหรือหลักสูตรที่คัดลอก ส่วนเสริมควรแสดงไฟล์แนบใหม่ให้นักเรียนทำให้เสร็จ และไม่ควรแสดงคำตอบของนักเรียนจากงานหรือหลักสูตรก่อนหน้าใน iframe |
แนะนำ | |
| 4.0 | การค้นพบไฟล์แนบ | ||
| 4.1 | หากไฟล์แนบกำหนดให้นักเรียนส่ง ไฟล์แนบต้องมี studentWorkReviewUri เพื่อให้ระบบจัดว่าเป็นประเภทกิจกรรม ไม่ใช่ไฟล์แนบประเภทเนื้อหา |
ต้องระบุ | |
| 4.2 | iframe การค้นพบไฟล์แนบต้องระบุอินเทอร์เฟซผู้ใช้ที่นำเสนอสิ่งต่อไปนี้อย่างน้อย 1 อย่าง
|
ต้องระบุ | |
| 4.3 | ครูควรสามารถค้นหาและเข้าถึงเนื้อหา/กิจกรรมทั้งหมดที่ครูสามารถใช้ได้ | แนะนำ | |
| 4.4 | ครูจะต้องสามารถดูตัวอย่างเนื้อหา/กิจกรรมได้ก่อนที่จะให้คำมั่นว่าจะแนบไฟล์นั้นไปกับงาน | ต้องระบุ | |
| 4.5 | หากครูจำเป็นต้องจัดทำเนื้อหา/กิจกรรมก่อนจึงจะแนบไฟล์ได้ ก็ควรทำงานนั้นใน iframe | แนะนำ | |
| 5.0 | มุมมองของนักเรียน | ||
| 5.1 | เมื่อเปิด studentViewUri ส่วนเสริมไม่ควรดึงผู้ใช้ออกจาก iframe เพื่อทำงานให้เสร็จสิ้นหากส่วนเสริมดึงผู้ใช้ออกจาก iframe จะต้องมีข้อความหรือตัวบ่งชี้อื่นๆ ให้นักเรียนกลับไปที่ Classroom |
แนะนำ | |
| 5.2 | หากกิจกรรมส่วนเสริมโผล่ออกมาจาก iframe จะต้องมีการแสดงตัวอย่างเกี่ยวกับงานใน iframe | ต้องระบุ | |
| 5.3 | ถ้านักเรียนต้องดำเนินการใดๆ เพื่อทำเครื่องหมายว่างานนั้นเสร็จแล้ว ปุ่ม "ต้องไม่" มีป้ายกำกับว่า "ส่งงาน" เพื่อไม่ให้สับสนกับปุ่มส่งงานของ Classroom | ต้องระบุ | |
| 6.0 | มุมมองของครู | ||
| 6.1 | ครูควรสามารถดูได้ว่านักเรียนจะเห็นอะไรบ้างเมื่อทำงาน | แนะนำ | |
| 7.0 | ตรวจงานของนักเรียน | ||
| 7.1 | หากเปิดใช้ studentWorkReviewUri ส่วนเสริมจะต้องแสดงผลงานของนักเรียนให้ครูตรวจภายใน iframe เนื้อหาเสริมอาจลิงก์ออกไปนอก iframe |
ต้องระบุ | |
| 7.2 | ส่วนเสริมต้องไม่เปิดการนำทางระหว่างนักเรียนทั้งหมดในมุมมอง studentWorkReviewUri การเข้าออกระหว่างนักเรียนจะต้องทำใน UI ของ Classroom เท่านั้น |
ต้องระบุ | |
| 8.0 | การสนับสนุนเกี่ยวกับ Classroom บนอุปกรณ์เคลื่อนที่ | ||
| 8.1 | เมื่อแอป Classroom บนอุปกรณ์เคลื่อนที่เปิด teacherViewUri, studentViewUri หรือ studentWorkReviewUri URL ต้องเปิดแอปที่มาพร้อมเครื่องในอุปกรณ์เคลื่อนที่ของพาร์ทเนอร์หรือเว็บแอปบนอุปกรณ์เคลื่อนที่ของพาร์ทเนอร์ และไม่ว่าในกรณีใดก็ตาม URL จะต้องทำ Deep Link ไปยังข้อมูลพร็อพเพอร์ตี้ที่ถูกต้อง หากอุปกรณ์ไม่ได้รับการรองรับ จะต้องแสดงข้อความเพื่อแจ้งให้ผู้ใช้ทราบว่าเป็นอุปกรณ์ที่ไม่รองรับ และโดยหลักการแล้ว มีอุปกรณ์ใดบ้างที่รองรับ |
ต้องระบุ | |
| 8.2 | นักเรียนควรทำงานในอุปกรณ์เคลื่อนที่ได้ | แนะนำ | |
| 9.0 | ฟีเจอร์เพิ่มเติม | ||
| 9.1 | หากครูสามารถวางลิงก์ไปยังเนื้อหาเป็นไฟล์แนบของลิงก์ได้ คุณควรอัปเกรดลิงก์เป็นไฟล์แนบของส่วนเสริม | แนะนำ | |
| 9.2 | หากใช้การผสานรวม CourseWork เพื่อสร้างงานจากภายนอก Classroom คุณควรสร้างไฟล์แนบของส่วนเสริมโดยค่าเริ่มต้นสำหรับลิงก์ทั้งหมดที่ใช้งานร่วมกับส่วนเสริมได้ | แนะนำ | |
บันทึกการเปลี่ยนแปลง
| รุ่น 1.0 | อัปเดตเมื่อ 30 เม.ย. 2024 |
| 1.1 | รวม 1.1 และ 1.2 เป็นข้อกำหนดเดียว |
| 2.1 | รวม 2.1 และ 2.5 เป็นข้อกำหนดเดียว |
| 2.2 | รวม 2.2, 2.3 และ 2.4 เป็นข้อกำหนดเดียว |
| 3.5 | รวม 3.5, 3.6 และ 3.7 เป็นข้อกำหนดเดียว |
| 3.10 | เพิ่มข้อกำหนดว่าส่วนเสริมต้องไม่อยู่ในสถานะเข้าใจไม่ได้หรือกู้คืนไม่ได้ |
| 3.11, 3.12 | รวม 5.5, 5.6, 6.3, 6.4, 7.5 และ 7.6 เป็นข้อกำหนดใหม่ 2 ข้อ |
| 4.2 | ขยายคำอธิบายของประสบการณ์การค้นพบไฟล์แนบที่ยอมรับได้ |
| 4.3 | เรียงลำดับใหม่ เดิมคือ 4.2 และเปลี่ยนจาก REQUIRED เป็น RECOMMENDED |
| 4.4 | เรียงลำดับใหม่ เดิมคือ 4.3 |
| 4.5 | เรียงลำดับใหม่ เดิมคือ 4.4 |
| 5.2 | เรียงลำดับเลขใหม่ เดิมคือ 5.3 |
| 5.3 | เรียงลำดับใหม่ เดิมคือ 5.2 |
| 9.1 | เพิ่มคำแนะนำให้อัปเกรดลิงก์ที่วางลงในไฟล์แนบ |
| 9.2 | เพิ่มคำแนะนำให้สร้างไฟล์แนบของส่วนเสริมโดยค่าเริ่มต้นเมื่อสร้างงานของ CourseWork แบบเป็นโปรแกรม |
| 2.6, 3.7, 3.8, 6.2, 7.3, 7.4 | นำออกแล้ว |
| เวอร์ชัน 0.3 | อัปเดตเมื่อวันที่ 22 พ.ย. 2022 |
| 2.3 | การแก้ไขคำแนะนำเกี่ยวกับคำแนะนำการเข้าสู่ระบบ |
| 2.4 | รวมสถานการณ์ที่จำเป็นต้องมีการติดตั้งใช้งาน hd |
| 3.2 | "ระบุเส้นทาง" ที่มีคำใหม่ |
| 5.5, 5.6, 6.3, 6.4, 7.5, 7.6 | เพิ่มสำเนาหลักสูตรที่จำเป็นและคำแนะนำที่แนะนำสำหรับ studentViewUri, teacherViewUri และ studentWorkReviewUri |
| เวอร์ชัน 0.2 | อัปเดตเมื่อ 29 ต.ค. 2021 |
| 1.3 | ปรับแต่งข้อความให้ชัดเจนยิ่งขึ้น |
| 3.1 | เพิ่มตัวเลือก "ส่วนเสริมต้องเป็นไปตามหลักเกณฑ์การอนุมัติทั่วไปของ GWM ในเว็บไซต์ของส่วนเสริม" |
| 3.9 | WCAG เปลี่ยน REQUIRED เป็น RECOMMENDED |
| 5.1 | เปลี่ยน "ต้องระบุ" เป็น "แนะนำ" แล้ว |
| 5.3 | เพิ่ม "หากส่วนเสริมโผล่ออกมาจาก iframe จะต้องมีการแสดงตัวอย่างเกี่ยวกับงานใน iframe" |
| 5.4 | เพิ่ม "หากส่วนเสริมโผล่ออกมาจาก iframe ควรมีข้อความแจ้งให้นักเรียนกลับไปยัง Classroom" |
| 8.1 | เพิ่ม "หากไม่รองรับอุปกรณ์ จะต้องแสดงข้อความเพื่อแจ้งให้ผู้ใช้ทราบว่าเป็นอุปกรณ์ที่ไม่รองรับ และโดยหลักแล้วควรรองรับอุปกรณ์ใดบ้าง" |
| 8.2 | เปลี่ยนงานของนักเรียนจาก REQUIRED เป็น RECOMMENDED แล้ว |
| เวอร์ชัน 0.1 | อัปเดตเมื่อ 22 กันยายน 2021 |
| การเผยแพร่ครั้งแรก |