แม้ว่านักพัฒนาแอปทุกคนจะส่งคำขอไปยัง 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
ในนามของผู้ใช้ได้