เวอร์ชัน 1.0, 30 เมษายน 2024
เกณฑ์ในหน้านี้มีผลกับส่วนเสริมของ Classroom ทั้งหมด ส่วนเสริมต้องเป็นไปตามรายการที่จำเป็นทั้งหมดที่เกี่ยวข้องจึงจะได้รับอนุมัติให้แสดงใน Google Workspace Marketplace และเป็นส่วนเสริมที่ "ทำงานร่วมกับ Classroom ได้"
คีย์เวิร์ด "ต้อง" "ต้องไม่" "ต้องระบุ" "ต้อง" "ต้องไม่" "ควร" "ไม่ควร" "แนะนำ" "อาจ" และ "ไม่บังคับ" ในเอกสารนี้ต้องตีความตามที่อธิบายไว้ใน RFC 2119
ข้อกำหนด
| รหัส | ประเภท | ||
|---|---|---|---|
| 1.0 | ใบอนุญาตผู้ใช้ปลายทาง (หากมี) | ||
| 1.1 | ข้อความที่เข้าใจง่ายต้องแสดงต่อผู้ใช้เมื่อผู้ใช้ไม่มีใบอนุญาต ข้อความต้องระบุสาเหตุที่ส่วนเสริมนี้ใช้ไม่ได้อย่างชัดเจน และแนะนำแนวทางการดำเนินการเพื่อให้ผู้ใช้แก้ไขสถานการณ์ | ต้องระบุ | |
| 1.3 | ข้อมูลใน Google Workspace Marketplace ของส่วนเสริมต้องระบุรายละเอียดเกี่ยวกับข้อกำหนดการอนุญาตให้ใช้สิทธิที่อาจจำเป็นสำหรับการใช้ส่วนเสริม หากส่วนเสริมมีระดับแบบชำระเงิน ข้อมูลผลิตภัณฑ์ใน Marketplace ต้องมีลิงก์ไปยังหน้าเว็บที่ให้ข้อมูลเพิ่มเติมเกี่ยวกับราคาหรือวิธีติดต่อพนักงานขาย | ต้องระบุ | |
| 2.0 | การลงชื่อเข้าใช้ของผู้ใช้ปลายทาง | ||
| 2.1 | ผู้ใช้ที่เป็นครูต้องลงชื่อเข้าใช้ส่วนเสริมโดยใช้ SSO ของ Google หากระบบขอให้ผู้ใช้ที่เป็นนักเรียนลงชื่อเข้าใช้ส่วนเสริม ผู้ใช้ต้องลงชื่อเข้าใช้โดยใช้ SSO ของ Google |
ต้องระบุ | |
| 2.2 | ส่วนเสริมต้องใช้ Google SSO เพื่อลงชื่อเข้าใช้ผู้ใช้โดยอัตโนมัติในการเข้าชมครั้งต่อๆ ไปโดยไม่ต้องแสดงข้อความแจ้งให้เข้าสู่ระบบ เมื่อคำใบ้การเข้าสู่ระบบไม่ตรงกับผู้ใช้ที่ลงชื่อเข้าใช้อยู่ในปัจจุบัน ส่วนเสริมต้องแจ้งให้ผู้ใช้ทราบด้วยปุ่มลงชื่อเข้าใช้และส่ง login_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 | ส่วนเสริมควรเป็นไปตามหลักเกณฑ์การช่วยเหลือพิเศษระดับ AA ของ WCAG 2.1 นักพัฒนาแอปส่วนเสริมจะรายงานด้วยตนเองว่าเป็นไปตามข้อกำหนดนี้ ณ เวลาที่ส่ง และส่วนเสริมจะยังคงเป็นไปตามการเปลี่ยนแปลงของส่วนเสริมในอนาคต | แนะนำ | |
| 3.10 | ข้อผิดพลาดที่ผู้ใช้พบต้องอ่านออกได้ | ต้องระบุ | |
| 3.11 | หากเปิด studentViewUri, teacherViewUri หรือ studentWorkViewUri จากงานที่คัดลอกหรือหลักสูตรที่คัดลอก ส่วนเสริมต้องไม่แสดงหน้าข้อผิดพลาดใน iframe |
ต้องระบุ | |
| 3.12 | หากเปิด studentViewUri, teacherViewUri หรือ studentWorkViewUri จากงานหรือหลักสูตรที่คัดลอกมา ส่วนเสริมควรแสดงไฟล์แนบใหม่เพื่อให้นักเรียนทำและไม่ควรแสดงคำตอบของนักเรียนจากงานหรือหลักสูตรก่อนหน้าใน iframe |
แนะนำ | |
| 4.0 | การค้นพบไฟล์แนบ | ||
| 4.1 | หากไฟล์แนบกำหนดให้นักเรียนส่ง ไฟล์แนบต้องมี studentWorkReviewUri เพื่อให้ระบบจัดว่าเป็นประเภทกิจกรรม ไม่ใช่ไฟล์แนบประเภทเนื้อหา |
ต้องระบุ | |
| 4.2 | iframe ของเครื่องมือค้นหาไฟล์แนบต้องมีอินเทอร์เฟซผู้ใช้ที่ให้บริการอย่างใดอย่างหนึ่งต่อไปนี้เป็นอย่างน้อย
|
ต้องระบุ | |
| 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 และเปลี่ยนจาก "ต้องระบุ" เป็น "แนะนำ" ด้วย |
| 4.4 | เปลี่ยนหมายเลขจากเดิม 4.3 |
| 4.5 | เปลี่ยนหมายเลขจากเดิม 4.4 |
| 5.2 | เปลี่ยนหมายเลขแล้ว จากเดิมคือ 5.3 |
| 5.3 | เปลี่ยนหมายเลขแล้ว จากเดิมคือ 5.2 |
| 9.1 | เพิ่มคําแนะนําให้อัปเกรดลิงก์ที่วางเป็นไฟล์แนบ |
| 9.2 | เพิ่มคําแนะนําให้สร้างไฟล์แนบของส่วนเสริมโดยค่าเริ่มต้นเมื่อสร้างงานในหลักสูตรด้วยโปรแกรม |
| 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 ซึ่งมีอยู่ในเว็บไซต์ของ GWM" |
| 3.9 | WCAG เปลี่ยน "ต้องระบุ" เป็น "แนะนำ" |
| 5.1 | เปลี่ยน "ต้องระบุ" เป็น "แนะนำ" แล้ว |
| 5.3 | เพิ่ม "หากส่วนเสริมปรากฏขึ้นจาก iframe จะต้องมีตัวอย่างเกี่ยวกับงานใน iframe" |
| 5.4 | เพิ่ม "หากส่วนเสริมโผล่ออกมาจาก iframe ควรมีข้อความแจ้งให้นักเรียนกลับไปที่ Classroom" |
| 8.1 | เพิ่ม "หากอุปกรณ์ไม่รองรับ ระบบต้องแสดงข้อความให้ผู้ใช้ทราบว่าอุปกรณ์ไม่รองรับ และควรระบุอุปกรณ์ที่รองรับ" |
| 8.2 | งานของนักเรียนบนอุปกรณ์เคลื่อนที่เปลี่ยนจาก "ต้องส่ง" เป็น "แนะนำ" |
| เวอร์ชัน 0.1 | อัปเดตเมื่อ 22 กันยายน 2021 |
| การเผยแพร่ครั้งแรก |