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

การดู สร้าง และแก้ไขงานของชั้นเรียนใน Classroom

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ไม่ได้ คุณสร้างข้อมูลผลิตภัณฑ์ 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 &Learning หรือ Education Plus เท่านั้น

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

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

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

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 ด้วยอีเมลได้ ระบบจะแสดงข้อมูลประจำตัวด้วยรหัสผู้ใช้และอีเมล ผู้ใช้ Google Workspace for Education สามารถเปลี่ยนอีเมลได้ ดังนั้นเราขอแนะนำให้คุณใช้รหัสผู้ใช้เป็นคีย์หลักเมื่อจัดเก็บข้อมูลผู้ใช้

ผู้ดูแลระบบของโรงเรียนต้องอนุมัติแอปไว้ล่วงหน้าเพื่อให้สิทธิ์นักเรียน/นักศึกษาลงชื่อเข้าใช้ไหม

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

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

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

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

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

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

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

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