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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ไม่ได้ คุณสร้างข้อมูล Google Workspace Marketplace 2 รายการสำหรับโปรเจ็กต์ 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

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

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

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

API

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

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

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

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

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

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

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

นักเรียนที่ใช้ป้าย Clever หรือ Classlink เพื่อลงชื่อเข้าใช้ Chromebook จะใช้การลงชื่อเข้าใช้ด้วย Google ได้ไหม

ได้ สมาชิกจะยังใช้การลงชื่อเข้าใช้ด้วย 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แท็ก