ข้อกำหนดส่วนเสริม

เวอร์ชัน 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 ส่วนเสริมต้องใช้ 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 เป็น แนะนำ
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
  การเผยแพร่ครั้งแรก