เวอร์ชัน 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 | ผู้ใช้ครูต้องลงชื่อเข้าใช้ส่วนเสริมด้วย Google SSO หากมีการขอให้ผู้ใช้ที่เป็นนักเรียนลงชื่อเข้าใช้ส่วนเสริม ผู้ใช้ต้องลงชื่อเข้าใช้ด้วย Google SSO |
ต้องระบุ | |
| 2.2 | ส่วนเสริมต้องใช้ SSO ของ Google เพื่อลงชื่อเข้าใช้ให้ผู้ใช้โดยอัตโนมัติในการเข้าชมครั้งต่อๆ ไปโดยไม่แสดงข้อความแจ้งให้เข้าสู่ระบบ เมื่อคำแนะนำการเข้าสู่ระบบไม่แสดงข้อมูลที่ตรงกับผู้ใช้ที่ลงชื่อเข้าใช้อยู่ในปัจจุบัน ส่วนเสริมจะต้องแจ้งให้ผู้ใช้ทราบด้วยปุ่มลงชื่อเข้าใช้และส่ง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 | ส่วนเสริมควรเป็นไปตามหลักเกณฑ์ 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 การค้นหาไฟล์แนบต้องมีอินเทอร์เฟซผู้ใช้ที่เสนอสิ่งต่อไปนี้อย่างน้อยหนึ่งรายการ:
|
ต้องระบุ | |
| 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 ดังกล่าวต้องเปิดแอปเนทีฟบนอุปกรณ์เคลื่อนที่หรือแอปบนอุปกรณ์เคลื่อนที่ของพาร์ทเนอร์ และในทั้ง 2 กรณี ระบบจะทำ 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 |
| การเผยแพร่ครั้งแรก |