การดู สร้าง และแก้ไขงานหลักสูตรใน Classroom
ฉันจะสร้างอะไรด้วยอุปกรณ์ปลายทางของ CourseWork ใน Classroom API ได้บ้าง
ปลายทางใหม่ช่วยให้นักพัฒนาซอฟต์แวร์ดูและจัดการงานในชั้นเรียนได้ โดยคุณสามารถดำเนินการต่อไปนี้ได้
- ดูงานและคำถาม (รวมเรียกว่า "งานหลักสูตร") ของผู้ใช้
- สร้าง แก้ไข และลบ CourseWork
- แนบสื่อการเรียนการสอนของชั้นเรียน (ไฟล์ในไดรฟ์, วิดีโอ YouTube, ลิงก์) ไปยัง CoursWork
- เปลี่ยนสถานะงานที่นักเรียนส่ง (เช่น ส่ง ส่งคืน เรียกคืน)
- กำหนดคะแนนสำหรับการส่งงาน
- แนบสื่อการเรียนการสอนของชั้นเรียน (ไฟล์ในไดรฟ์, วิดีโอ YouTube, ลิงก์) กับการส่งงานของนักเรียน
ตัวอย่างกรณีการใช้งานสำหรับ CourseWork
- สมุดพก, SIS หรือระบบการรายงานสามารถซิงค์งานและคะแนนจาก Classroom ไปยังแอปพลิเคชันของตัวเอง ทำให้ไม่ต้องโอนข้อมูลด้วยตนเอง
- แอปพลิเคชันการเรียนรู้สามารถสร้างงานใหม่ที่ปรากฏในสตรีมของชั้นเรียน เมื่อนักเรียนทำงานเสร็จ แอปพลิเคชันจะสามารถส่งงาน ให้คะแนน แนบงานของนักเรียน และจัดเก็บงานไว้ในโฟลเดอร์ไดรฟ์ที่เหมาะสมได้
- ผู้ใช้ที่เป็นครูสามารถสร้างงานด้วยไฟล์แนบของส่วนเสริมจากเว็บไซต์หรือแอปพลิเคชันของคุณ
- ผู้ใช้ที่เป็นนักเรียนจะส่งงานที่มีไฟล์แนบของส่วนเสริมได้
แอปพลิเคชันของฉันต้องมีสิทธิ์ใดบ้างในการสร้างหรือแก้ไขงาน
โดยปกติแล้ว แอปพลิเคชันจะแก้ไขได้เฉพาะงานที่สร้างขึ้นเท่านั้น กล่าวคือ คำขอ API การเปลี่ยนแปลงการมอบหมายต้องใช้รหัสโปรเจ็กต์ Google Cloud เดียวกับที่จัดเก็บไว้ในเวลาที่สร้างการมอบหมาย
ส่วนเสริมของ Google Classroom มีข้อยกเว้นสำหรับกฎนี้ โปรเจ็กต์ที่อยู่ในระบบคลาวด์จะเข้าถึงหรือแก้ไขประกาศ งาน หรือเนื้อหาใดก็ตามที่มีไฟล์แนบของส่วนเสริมอย่างน้อย 1 รายการได้ โปรเจ็กต์ที่อยู่ในระบบคลาวด์ยังสามารถส่ง อ้างสิทธิ์ หรือส่งคืนงานที่มีไฟล์แนบของส่วนเสริมอย่างน้อย 1 รายการได้อีกด้วย
คำขอ API จำเป็นต้องมีขอบเขตของผู้ใช้ที่ถูกต้องด้วย ครูสามารถดูงาน สร้างงาน แนบลิงก์ไปยังงานที่ส่ง และให้คะแนนงานที่ส่งได้ นักเรียนสามารถดูงาน แนบลิงก์ไปยังบันทึกงาน จากนั้นส่งและเรียกคืนงานที่ส่งได้ ผู้ดูแลระบบโดเมนจะดู CourseWork ได้ แต่ไม่มีสิทธิ์เขียน
ใบสมัครของฉันสามารถแนบไปกับงานหรือการส่งงานประเภทใด
API รองรับการแนบไฟล์ในไดรฟ์ วิดีโอ YouTube และลิงก์ ระบบยังไม่รองรับการแนบ Google ฟอร์มที่มาพร้อมเครื่อง
ผู้ใช้ปลายทางรู้ไหมว่างานใน Classroom สร้างขึ้นโดยแอปพลิเคชันของฉัน
ใช่ UI ของ Classroom จะระบุงานที่สร้างภายนอก โดยใช้ชื่อผลิตภัณฑ์ของโปรเจ็กต์ Google Cloud ที่สร้างงานดังกล่าว ผู้ใช้สามารถรายงานงานที่สร้างขึ้นภายนอกว่าเป็นงานที่ไม่ต้องการ รวมทั้งยกเลิกการเชื่อมต่อแอปพลิเคชันที่สร้างผลงานนั้นได้ด้วยการเพิกถอนข้อมูลเข้าสู่ระบบที่ออกให้กับแอปพลิเคชันของผู้ใช้
ปุ่มแชร์ใน Classroom และการผสานรวมอื่นๆ
ฉันผสานรวมกับปุ่มแชร์ของ Classroom แล้ว ฉันจะแก้ไขงานที่สร้างขึ้นโดยใช้ปุ่มแชร์ได้ไหม
ยังไม่มี หากต้องการแก้ไขงาน คำขอต้องใช้โปรเจ็กต์ Google Cloud เดียวกันกับที่สร้างการมอบหมาย
ฉันตอบคำถามใน API ได้ไหม
ยังไม่มี คุณสร้างและแก้ไขคำถามได้ เรามีแผนกลยุทธ์ในการตอบคำถาม แบบเป็นโปรแกรม
ส่วนเสริมของ Classroom
การกำหนดค่าโปรเจ็กต์
ฉันจะแปลงโปรเจ็กต์ Google Cloud ส่วนตัวที่ใช้ระหว่างการพัฒนาเป็นโปรเจ็กต์สาธารณะที่ใช้ในเวอร์ชันที่ใช้งานจริงได้ไหม
คุณแปลงโปรเจ็กต์ Google Cloud ส่วนตัวเป็นโปรเจ็กต์สาธารณะไม่ได้ คุณต้องมีโปรเจ็กต์แยกกัน 2 โปรเจ็กต์ โปรเจ็กต์หนึ่งสำหรับการพัฒนาและอีกโปรเจ็กต์หนึ่งสำหรับเวอร์ชันที่ใช้งานจริง
โปรเจ็กต์ Google Cloud โปรเจ็กต์เดียวจะมีข้อมูล GWM 2 รายการได้ไหม
ไม่ได้ คุณไม่สามารถสร้างข้อมูล GWM 2 รายการสำหรับโปรเจ็กต์ Google Cloud โปรเจ็กต์เดียว
แต่คุณจะรวมส่วนเสริมเข้าด้วยกันได้ วิธีนี้จะช่วยให้ข้อมูล GWM รายการเดียวแสดงส่วนเสริมหลายรายการได้ การติดตั้งจากข้อมูลนั้นๆ จะเป็นการติดตั้งส่วนเสริมทั้งหมดในแพ็กเกจพร้อมกัน ผู้ใช้จะต้องให้ความยินยอมตามขอบเขตทั้งหมดที่จำเป็นจากการรวมส่วนเสริมเมื่อให้สิทธิ์
ข้อควรพิจารณาเพิ่มเติม 2 ประการเกี่ยวกับการจัดแพ็กเกจมีดังนี้
ส่วนเสริม Classroom มีให้บริการสําหรับผู้สมัครใช้บริการ Teaching & Learning Upgrade หรือ SKU รุ่น Education Plus เท่านั้น
API ของส่วนเสริมอยู่ในช่วงทดลองใช้ก่อนเปิดตัวและจํากัดไว้สําหรับนักพัฒนาซอฟต์แวร์ที่เข้าร่วมและโปรเจ็กต์ Google Cloud เท่านั้น ส่วนเสริมที่รวมไว้อาจทำงานไม่ได้ตามที่ต้องการหากต้องใช้โปรเจ็กต์ Google Cloud ที่ไม่ได้เข้าร่วม
ไคลเอ็นต์ OAuth จากโปรเจ็กต์ Google Cloud อื่นจะนำไปใช้ซ้ำกับส่วนเสริมของโปรเจ็กต์ Google Cloud สำหรับ Classroom ได้ไหม
ไม่ได้ ไคลเอ็นต์ OAuth จากโปรเจ็กต์ Google Cloud อื่นที่ไม่ใช่โปรเจ็กต์ Google Cloud ซึ่งเป็นส่วนเสริมของ Classroom จะทำงานไม่ได้ Classroom API ปฏิเสธโทเค็นเพื่อการเข้าถึงที่สร้างโดยโปรเจ็กต์ Google Cloud อื่น คุณต้องสร้างไคลเอ็นต์ OAuth แยกต่างหากสำหรับโปรเจ็กต์ส่วนเสริม
ประสบการณ์ของผู้ใช้
โลโก้ของเราจัดวางได้พอดีภายในสี่เหลี่ยมจัตุรัสขนาดเล็ก มีตัวเลือกขนาดใดบ้างสำหรับโลโก้ในแถบชื่อ iframe
แถบชื่อของ iframe ได้รับการออกแบบมาให้รองรับโลโก้สี่เหลี่ยมจัตุรัสขนาด 32x32 เท่านั้น ตัวเลือกนี้สร้างขึ้นเพื่อให้เข้ากับรูปร่างของไอคอน Fav ที่บริษัทใช้ในเว็บไซต์ และเป็นคำแนะนำในการใช้โลโก้เดียวกันในพื้นที่เพื่อให้แบรนด์สอดคล้องกัน
โดเมน
ครูและนักเรียนทั้งหมดในโดเมนเดียวกันมีสิทธิ์เข้าถึงส่วนเสริมที่ติดตั้งไว้ไหม
ผู้ดูแลระบบของโรงเรียนมีสิทธิ์กำหนดได้ว่าจะให้ครูคนใดเห็นส่วนเสริมที่ติดตั้งไว้
ผู้ดูแลระบบโดเมนโต้ตอบกับส่วนเสริมอย่างไร
ผู้ดูแลระบบโดเมน (ผู้ดูแลระบบ) จะควบคุมว่าใครใช้ส่วนเสริมของคุณได้ ลูกค้าสามารถติดตั้งส่วนเสริมสำหรับทั้งโดเมนโดยใช้ตัวเลือกการติดตั้งของผู้ดูแลระบบ หากติดตั้งส่วนเสริมทีละรายการได้ โปรดทราบว่าผู้ดูแลระบบส่วนใหญ่จะมีรายการที่อนุญาตของส่วนเสริม ส่วนครูจะติดตั้งส่วนเสริมในรายการนี้ได้สำหรับตนเอง ผู้ดูแลระบบอาจเลือกติดตั้งส่วนเสริมทีละรายการเพื่อการทดสอบได้เช่นกัน
ผู้ดูแลระบบอาจสนใจสถิติการใช้งานเกี่ยวกับส่วนเสริมของคุณ หากผลิตภัณฑ์ของคุณรองรับ ให้พิจารณาระบุสถิติการใช้งานส่วนเสริมในมุมมองของผู้ดูแลระบบในเว็บไซต์
API
วิธีใดคือวิธีที่เชื่อถือได้ในการตรวจสอบว่าหน้าพาร์ทเนอร์โหลดภายใน iframe หรือแท็บในหน้าต่างใหม่
ปัจจุบันเรายังไม่มีวิธีแยกความแตกต่างระหว่าง 2 วิธีนี้
รายการงานใดที่มอบหมายได้ที่ได้รับ iframe การตรวจสอบงานของนักเรียน
iframe การตรวจสอบงานของนักเรียนมีให้สำหรับไฟล์แนบประเภทกิจกรรมเท่านั้น
เรียกใช้เมธอด courses.courseWork.getAddOnContext เพื่อดูว่าโพสต์ประเภทนั้นๆ สนับสนุนงานของนักเรียนหรือไม่ ช่อง supportsStudentWork จะเป็น true ได้สำหรับประเภทโพสต์ที่เป็นกิจกรรมเท่านั้น
อาจมีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบของ API ในระหว่างโปรแกรมทดลองใช้ก่อนเปิดตัวได้ไหม
API ของส่วนเสริมยังอยู่ระหว่างการพัฒนา ดังนั้นจึงอาจเกิดการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นของ API ซึ่งทำให้คำขอที่สำเร็จก่อนหน้านี้ล้มเหลวหรือทำงานแตกต่างออกไป คุณรับการแจ้งเตือนการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบล่วงหน้าได้ผ่านทางฟอรัมนักพัฒนาซอฟต์แวร์
ไฟล์แนบของส่วนเสริมจะเข้าถึงรายการสตรีมที่แนบได้ไหม
ใช่ คุณสามารถ get หรือ patch โดเมน Announcement, CourseWork หรือ CourseWorkMaterial ที่มีไฟล์แนบของส่วนเสริมอย่างน้อย 1 รายการ
คุณสามารถreclaim return หรือturnIn CourseWork StudentSubmission
ส่วนเสริมของ Classroom จะเปิดตัวต่อสาธารณะเมื่อใด
ส่วนเสริมของ Classroom พร้อมให้บริการสำหรับผู้ใช้ปลายทางทุกคนตั้งแต่ฤดูร้อนปี 2022 API ส่วนเสริมคาดว่าจะพร้อมใช้งานสำหรับนักพัฒนาแอปโดยทั่วไปในช่วงปี 2024
การลงชื่อเพียงครั้งเดียว
นักเรียนที่ใช้ป้าย Clever หรือ Classlink เพื่อลงชื่อเข้าใช้ Chromebook จะใช้ Google Sign-In ได้ไหม
ได้ ผู้ใช้จะยังคงใช้ Google Sign-In ได้
นักเรียนทุกคนมีอีเมลที่มีรูปแบบที่ถูกต้อง แม้ว่าจะไม่มีสิทธิ์เข้าถึง Gmail ใช่ไหม
ผู้ใช้ Google Workspace for Education ทุกคนจะมีข้อมูลประจำตัวของ Google ไม่ว่าจะมีสิทธิ์เข้าถึง Gmail หรือไม่ก็ตาม ข้อมูลระบุตัวตนจะแสดงด้วยอีเมล ข้อมูลประจำตัวและการเข้าถึงบริการเฉพาะใดๆ ของ Google (รวมถึง Gmail) นั้นแตกต่างกัน ดังนั้น แม้จะปิดใช้ Gmail แล้ว ผู้ใช้ที่เป็นนักเรียนก็ลงชื่อเข้าใช้ด้วยอีเมลได้
ผู้ดูแลระบบของโรงเรียนต้องอนุมัติแอปล่วงหน้าเพื่อให้นักเรียนลงชื่อเข้าใช้ได้ไหม
ผู้ดูแลระบบโดเมนต้องอนุญาตส่วนเสริมก่อนจึงจะติดตั้งได้ หรือผู้ดูแลระบบโดเมนอาจติดตั้งส่วนเสริมให้กับผู้ใช้ทั้งหมดภายในโดเมนหรือหน่วยขององค์กรก็ได้
ความคิดเห็นและคำถามทั่วไป
ฉันจะส่งคำขอฟีเจอร์หรือปัญหาเกี่ยวกับคำขอได้อย่างไร
คุณส่ง ดู และโหวตให้กับคำขอฟีเจอร์ได้ในเครื่องมือติดตามปัญหาแบบสาธารณะ
ฉันจะรู้ได้อย่างไรว่า Classroom API มีฟีเจอร์ใหม่ให้ใช้
การอัปเดต API จะโพสต์อยู่ในหน้าบันทึกประจำรุ่น ฟอรัมนักพัฒนาซอฟต์แวร์ และเครื่องมือติดตามปัญหาแบบสาธารณะ
ฉันใช้ Classroom API ฉันจะถามคำถามทางเทคนิคได้อย่างไร
โพสต์คำถามใน Stack Overflow โดยใช้แท็ก google-classroom