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

การดู สร้าง และแก้ไขงานในหลักสูตรใน Classroom

ฉันจะสร้างอะไรได้บ้างโดยใช้ปลายทางของ CourseWork ใน Classroom API

ปลายทางช่วยให้นักพัฒนาแอปดูและจัดการงานในชั้นเรียนได้ กล่าวโดยละเอียดคือ คุณจะทำสิ่งต่อไปนี้ได้ทั้งหมด

  • ดูงานและคำถาม (เรียกรวมกันว่า CourseWork) สำหรับผู้ใช้
  • สร้าง แก้ไข และลบ CourseWork
  • แนบสื่อ (ไฟล์ในไดรฟ์ วิดีโอ YouTube ลิงก์) ไปกับ CourseWork
  • เปลี่ยนสถานะการส่งของนักเรียน (เช่น ส่งแล้ว ส่งคืนแล้ว รับคืนแล้ว)
  • กำหนดคะแนนสำหรับงานที่ส่ง
  • แนบสื่อ (ไฟล์ในไดรฟ์, วิดีโอ YouTube, ลิงก์) ไปกับงานที่นักเรียนส่ง

ตัวอย่างกรณีการใช้งาน CourseWork

  • สมุดบันทึกคะแนน, SIS หรือระบบการรายงานสามารถซิงค์งานและคะแนนจาก Classroom ไปยังแอปพลิเคชันของตนได้ ซึ่งจะช่วยลดการโอนข้อมูลด้วยตนเอง
  • แอปพลิเคชันการเรียนรู้สามารถสร้างงานใหม่ซึ่งจะปรากฏในสตรีมของชั้นเรียน เมื่อนักเรียนทำงานเสร็จแล้ว แอปพลิเคชันจะส่งงาน ให้คะแนน แนบงานของนักเรียน และจัดเก็บงานในโฟลเดอร์ไดรฟ์ที่เหมาะสมได้
  • ผู้ใช้ที่เป็นครูสามารถสร้างงานที่มีไฟล์แนบของส่วนเสริมจากเว็บไซต์หรือแอปพลิเคชันของคุณ
  • ผู้ใช้ที่เป็นนักเรียนจะส่งงานที่มีไฟล์แนบของส่วนเสริมได้

แอปพลิเคชันของฉันต้องมีสิทธิ์ใดบ้างในการสร้างหรือแก้ไขงาน

โดยทั่วไปแล้ว แอปพลิเคชันจะแก้ไขได้เฉพาะงานที่สร้างขึ้นเท่านั้น กล่าวคือ คำขอ API ใดๆ ในการแก้ไข CourseWork ต้องใช้รหัสโปรเจ็กต์ Google Cloud เดียวกันกับที่ใช้สร้าง CourseWork

ส่วนเสริมของ Google Classroom มีข้อยกเว้นสำหรับกฎนี้ โปรเจ็กต์ใน Cloud สามารถเข้าถึงหรือแก้ไขประกาศ งาน หรือสื่อการเรียนการสอนของชั้นเรียนที่มีไฟล์แนบของส่วนเสริมอย่างน้อย 1 รายการ โปรเจ็กต์ในไดรฟ์บนระบบคลาวด์ยังส่งคืน อ้างสิทธิ์ หรือส่งงานที่มีไฟล์แนบของส่วนเสริมอย่างน้อย 1 รายการได้ด้วย

นอกจากนี้ คำขอ API ยังต้องมีขอบเขตผู้ใช้ที่ถูกต้องด้วย ครูจะดูงาน สร้างงาน แนบลิงก์ไปยังงานที่ส่ง และกำหนดคะแนนงานที่ส่งได้ นักเรียนสามารถดูงาน แนบลิงก์ไปยังบันทึกงาน ตลอดจนส่งและเรียกคืนงานที่ส่ง ผู้ดูแลระบบโดเมนดู CourseWork ได้ แต่ไม่มีสิทธิ์เขียน

แอปพลิเคชันของฉันแนบรายการประเภทใดไปกับงานหรือข้อมูลที่ส่งได้บ้าง

API รองรับการแนบไฟล์ในไดรฟ์ วิดีโอ YouTube และลิงก์ ระบบยังไม่รองรับการแนบ Google Forms ในตัว

ผู้ใช้ปลายทางจะทราบว่างานใน Classroom สร้างขึ้นโดยแอปพลิเคชันของฉันไหม

ได้ UI ของ Classroom จะระบุงานที่สร้างภายนอกโดยใช้ชื่อผลิตภัณฑ์ของโปรเจ็กต์ Google Cloud ที่สร้างงาน ผู้ใช้สามารถรายงานว่างานที่สร้างจากภายนอกไม่พึงประสงค์ รวมถึงยกเลิกการเชื่อมต่อแอปพลิเคชันที่สร้างงานโดยการเพิกถอนข้อมูลเข้าสู่ระบบที่ผู้ใช้ออกให้แอปพลิเคชัน

ปุ่มแชร์ใน Classroom และการผสานรวมอื่นๆ

ฉันผสานรวมกับปุ่มแชร์ของ Classroom แล้ว ฉันจะแก้ไขงานที่สร้างขึ้นโดยใช้ปุ่มแชร์ได้ไหม

ยังไม่มี หากต้องการแก้ไขงาน คำขอต้องใช้โปรเจ็กต์ Google Cloud เดียวกันกับที่สร้างงาน

ฉันจะตอบคําถามใน API ได้ไหม

ยังไม่มี คุณสามารถสร้างและแก้ไขคำถามได้

ส่วนเสริมของ Classroom

การกำหนดค่าโปรเจ็กต์

ฉันจะแปลงโปรเจ็กต์ Google Cloud ส่วนตัวที่ใช้ระหว่างการพัฒนาเป็นโปรเจ็กต์สาธารณะที่ใช้ในเวอร์ชันที่ใช้งานจริงได้ไหม

ไม่ได้ คุณจะแปลงโปรเจ็กต์ Google Cloud ส่วนตัวเป็นโปรเจ็กต์สาธารณะไม่ได้ คุณต้องมีโปรเจ็กต์แยกกัน 2 โปรเจ็กต์ โปรเจ็กต์หนึ่งสำหรับการพัฒนาและอีกโปรเจ็กต์สำหรับเวอร์ชันที่ใช้งานจริง

โปรเจ็กต์ Google Cloud รายการเดียวมีข้อมูลผลิตภัณฑ์ใน Google Workspace Marketplace ได้ 2 รายการไหม

ไม่ได้ คุณสร้างข้อมูลผลิตภัณฑ์ 2 รายการใน Google Workspace Marketplace สำหรับโปรเจ็กต์ Google Cloud โปรเจ็กต์เดียวไม่ได้

อย่างไรก็ตาม คุณสามารถรวมส่วนเสริมได้ ซึ่งจะช่วยให้ข้อมูลผลิตภัณฑ์เดียวใน Google Workspace Marketplace แสดงถึงส่วนเสริมหลายรายการได้ การติดตั้งจากข้อมูลดังกล่าวจะติดตั้งส่วนเสริมทั้งหมดในแพ็กเกจพร้อมกัน ผู้ใช้จะต้องให้ความยินยอมในขอบเขตทั้งหมดที่จําเป็นสําหรับส่วนเสริมที่รวมอยู่ด้วยเมื่อให้สิทธิ์

ฉันนำไคลเอ็นต์ OAuth จากโปรเจ็กต์ Google Cloud อื่นมาใช้กับโปรเจ็กต์ Google Cloud สำหรับส่วนเสริมของ Classroom ได้ไหม

ไม่ได้ ไคลเอ็นต์ OAuth จากโปรเจ็กต์ Google Cloud อื่นที่ไม่ใช่โปรเจ็กต์ Google Cloud ของส่วนเสริม Classroom จะใช้ไม่ได้ Classroom API จะปฏิเสธโทเค็นการเข้าถึงที่สร้างขึ้นโดยโปรเจ็กต์ Google Cloud อื่น คุณต้องสร้างไคลเอ็นต์ OAuth แยกต่างหากสำหรับโปรเจ็กต์ส่วนเสริม

ประสบการณ์ของผู้ใช้

โลโก้ของเราไม่พอดีกับสี่เหลี่ยมจัตุรัสขนาดเล็ก ตัวเลือกขนาดของโลโก้ในแถบชื่อ iframe ของส่วนเสริม Classroom มีตัวเลือกอะไรบ้าง

แถบชื่อ iframe ออกแบบมาเพื่อรองรับเฉพาะโลโก้สี่เหลี่ยมจัตุรัสขนาด 32x32 เท่านั้น ตัวเลือกนี้ทำขึ้นเพื่อให้ตรงกับรูปร่างของ Favicon ที่บริษัทใช้บนเว็บไซต์ของตน และเราแนะนำให้ใช้โลโก้เดียวกันในพื้นที่นี้เพื่อให้แบรนด์มีความสอดคล้องกัน

โดเมน

ครูและนักเรียนทุกคนในโดเมนเดียวกันมีสิทธิ์เข้าถึงส่วนเสริมที่ติดตั้งไว้ไหม

ผู้ดูแลระบบโดเมนสามารถควบคุมได้ว่าครูคนใดบ้างที่จะเห็นส่วนเสริมที่ติดตั้งไว้ ส่วนเสริมของ Classroom ใช้ได้เฉพาะกับผู้ใช้ที่มีใบอนุญาต Teaching and Learning หรือ Education Plus

ผู้ดูแลระบบโดเมนโต้ตอบกับส่วนเสริมอย่างไร

ผู้ดูแลระบบโดเมนจะควบคุมได้ว่าใครจะใช้ส่วนเสริมของคุณได้ โดยสามารถติดตั้งส่วนเสริมสำหรับทั้งโดเมนได้โดยใช้ตัวเลือกการติดตั้งของผู้ดูแลระบบ หากติดตั้งส่วนเสริมทีละรายการได้ โปรดทราบว่าผู้ดูแลระบบส่วนใหญ่จะดูแลรักษารายการที่อนุญาตสำหรับส่วนเสริม โดยครูที่อยู่ในรายการนี้จะติดตั้งส่วนเสริมได้เอง นอกจากนี้ ผู้ดูแลระบบอาจเลือกที่จะติดตั้งส่วนเสริมของคุณทีละรายการเพื่อวัตถุประสงค์ในการทดสอบด้วย

ผู้ดูแลระบบอาจสนใจสถิติการใช้งานเกี่ยวกับส่วนเสริมของคุณด้วย หากผลิตภัณฑ์รองรับ ให้พิจารณาแสดงสถิติการใช้งานส่วนเสริมในมุมมองผู้ดูแลระบบในเว็บไซต์ของคุณเอง

API

วิธีที่เชื่อถือได้ในการทราบว่าเนื้อหาของส่วนเสริมโหลดภายใน iframe หรือแท็บใหม่คืออะไร

ปัจจุบันยังไม่มีวิธีแยกความแตกต่างระหว่าง 2 รายการนี้

รายการงานที่กำหนดได้รายการใดบ้างที่จะมี iframe ของการตรวจสอบงานของนักเรียน

เฟรมย่อยของรีวิวงานของนักเรียนมีไว้สำหรับไฟล์แนบประเภทกิจกรรมเท่านั้น เรียกเมธอด courses.courseWork.getAddOnContext เพื่อดูว่าประเภทโพสต์รองรับงานของนักเรียนหรือไม่ ฟิลด์ supportsStudentWork ต้องเป็น true เท่านั้นสำหรับโพสต์ประเภทที่เป็นกิจกรรม

ไฟล์แนบของส่วนเสริมเข้าถึงรายการสตรีมที่แนบอยู่ได้ไหม

ได้ คุณสามารถgetหรือpatch Announcement, CourseWork หรือ CourseWorkMaterial ที่มีไฟล์แนบของส่วนเสริมอย่างน้อย 1 รายการ คุณสามารถreclaim, return หรือ turnIn CourseWork StudentSubmission ได้

การลงชื่อเพียงครั้งเดียว

ได้ ผู้ใช้จะยังใช้ฟีเจอร์ลงชื่อเข้าใช้ด้วย Google ได้

นักเรียนทุกคนมีอีเมลที่มีรูปแบบถูกต้องไหม แม้ว่าจะไม่มีสิทธิ์เข้าถึง Gmail ก็ตาม

ผู้ใช้ Google Workspace for Education ทุกคนจะมีข้อมูลประจำตัวของ Google ไม่ว่าจะมีสิทธิ์เข้าถึง Gmail หรือไม่ก็ตาม ตัวตนและการเข้าถึงบริการใดๆ ของ Google (รวมถึง Gmail) นั้นแตกต่างกัน แม้ว่าจะปิดใช้ Gmail อยู่ ผู้ใช้ที่เป็นนักเรียนจะยังลงชื่อเข้าใช้ Classroom ด้วยอีเมลได้ ข้อมูลระบุตัวตนจะแสดงด้วยรหัสผู้ใช้และอีเมล ผู้ใช้ Google Workspace for Education สามารถเปลี่ยนอีเมลได้ เราจึงขอแนะนำให้ใช้รหัสผู้ใช้เป็นคีย์หลักเมื่อจัดเก็บข้อมูลผู้ใช้

ผู้ดูแลระบบของโรงเรียนต้องอนุมัติแอปล่วงหน้าเพื่ออนุญาตให้นักเรียนลงชื่อเข้าใช้หรือไม่

ผู้ดูแลระบบโดเมนต้องเพิ่มลงในรายการที่อนุญาตก่อนจึงจะติดตั้งส่วนเสริมได้ ผู้ดูแลระบบโดเมนสามารถติดตั้งส่วนเสริมให้กับผู้ใช้ทุกคนภายในโดเมนหรือหน่วยขององค์กรได้ (ไม่บังคับ)

ความคิดเห็นและคำถามทั่วไป

ฉันจะส่งคำขอฟีเจอร์หรือแจ้งปัญหาได้อย่างไร

คุณสามารถส่ง ดู และโหวตคำขอฟีเจอร์ในเครื่องมือติดตามปัญหาสาธารณะ

ฉันจะทราบได้อย่างไรว่าฟีเจอร์ใหม่พร้อมใช้งานใน Classroom API แล้ว

การอัปเดต API จะโพสต์ไว้ในจดหมายข่าวสำหรับนักพัฒนาแอปและเครื่องมือติดตามปัญหาสาธารณะ

ฉันใช้ Classroom API ฉันจะถามคําถามทางเทคนิคได้อย่างไร

โพสต์คำถามใน Stack Overflow โดยใช้แท็ก google-classroom