แม้ว่านักพัฒนาแอปทุกคนจะส่งคำขอไปยัง 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 ที่ขอ | CREATE_ADD_ON_ATTACHMENT |
| แก้ไขการตั้งค่าระยะเวลาการให้คะแนนได้ | UPDATE_GRADING_PERIOD_SETTINGS |
| สร้างหรือแก้ไขเกณฑ์การให้คะแนนได้ | CREATE_RUBRIC |
จากนั้นตรวจสอบช่อง allowed ในการตอบกลับ หาก allowed เป็น true ผู้ใช้จะมีสิทธิ์เข้าถึง Capability ที่เลือก จากนั้นคุณจะส่งคําขอ API ที่เกี่ยวกับ Capability ในนามของผู้ใช้ได้