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

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

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

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

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

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

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

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

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

ส่วนเสริมของ 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 จะมีตัวเลือกขนาดใดบ้าง

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

โดเมน

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

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

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

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

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

API

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

ขณะนี้ยังไม่มีวิธีแยกความแตกต่างระหว่าง 2 รายการนี้

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

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 API มาพร้อมฟีเจอร์ใหม่ๆ เมื่อใด

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

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

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