แม้ว่านักพัฒนาแอปทุกคนจะส่งคำขอไปยัง Google Classroom API ได้ แต่ฟีเจอร์บางอย่างของ Google Classroom มีให้บริการแก่ผู้ใช้บางรายเท่านั้น ฟีเจอร์แต่ละอย่างอาจมีข้อกำหนดที่แตกต่างกัน เช่น การมีใบอนุญาต Google Workspace for Education บางประเภท ดูรายละเอียดฟีเจอร์ที่มาพร้อมกับใบอนุญาต Google Workspace for Education แต่ละระดับได้ที่หน้าเปรียบเทียบรุ่น
ฟีเจอร์ที่มีข้อกำหนดของการได้รับสิทธิ์
ฟีเจอร์ Classroom API ต่อไปนี้พร้อมให้บริการแก่ผู้ใช้ที่มีสิทธิ์เท่านั้น
- การสร้างและการแก้ไขไฟล์แนบของส่วนเสริม Classroom
- แก้ไขการตั้งค่าระยะเวลาการให้คะแนน
- การสร้าง แก้ไข และลบรูปแบบการให้คะแนน
กำหนดความสามารถของผู้ใช้
คำขอไปยัง Classroom API จะทำในนามของผู้ใช้แต่ละราย ดังนั้น คุณควรตรวจสอบว่าผู้ใช้มีความสามารถที่เหมาะสมหรือไม่ก่อนที่จะส่งคําขอ API ที่มีข้อกําหนดของการได้รับสิทธิ์
หากต้องการตรวจสอบว่าผู้ใช้มีสิทธิ์บางอย่างหรือไม่ ให้ส่งคําขอ API ไปยังเมธอด checkUserCapability
ใส่ประเภท Capability
ที่เหมาะสมสำหรับฟีเจอร์ Classroom ที่ต้องการใช้ ระบุ Capability
ที่เหมาะสมสำหรับฟีเจอร์แต่ละรายการ
วิธีดูว่าผู้ใช้... | Capability |
---|---|
สร้างหรือแก้ไขไฟล์แนบของส่วนเสริม Classroom ที่เชื่อมโยงกับโปรเจ็กต์ Google Cloud ของรหัสไคลเอ็นต์ OAuth ที่ใช้ส่งคำขอได้ | CREATE_ADD_ON_ATTACHMENT |
แก้ไขการตั้งค่าระยะเวลาการให้คะแนนได้ | UPDATE_GRADING_PERIOD_SETTINGS |
สร้าง แก้ไข หรือลบเกณฑ์การให้คะแนนได้ | CREATE_RUBRIC |
ถัดไป ให้ตรวจสอบช่อง allowed
ในการตอบกลับ หาก allowed
เป็น true
ผู้ใช้จะมีสิทธิ์เข้าถึง Capability
ที่เลือก จากนั้นคุณจะส่งคําขอ API ที่เกี่ยวข้องกับ Capability
ในนามของผู้ใช้ได้