การมีสิทธิ์ของผู้ใช้

แม้ว่านักพัฒนาแอปทุกคนจะส่งคำขอไปยัง Google Classroom API ได้ แต่ฟีเจอร์บางอย่างของ Google Classroom มีให้บริการแก่ผู้ใช้บางรายเท่านั้น ฟีเจอร์แต่ละอย่างอาจมีข้อกำหนดที่แตกต่างกัน เช่น การมีใบอนุญาต Google Workspace for Education บางประเภท ดูรายละเอียดฟีเจอร์ที่มาพร้อมกับใบอนุญาต Google Workspace for Education แต่ละระดับได้ที่หน้าเปรียบเทียบรุ่นต่างๆ

ฟีเจอร์ที่มีข้อกำหนดของการได้รับสิทธิ์

ฟีเจอร์ Classroom API ต่อไปนี้พร้อมให้บริการแก่ผู้ใช้ที่มีสิทธิ์เท่านั้น

กำหนดความสามารถของผู้ใช้

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

หากต้องการตรวจสอบว่าผู้ใช้มีสิทธิ์บางอย่างหรือไม่ ให้ส่งคําขอ API ไปยังเมธอด checkUserCapability ระบุประเภท Capability ที่เหมาะสมสำหรับฟีเจอร์ Classroom ที่ต้องการใช้ ระบุ Capability ที่เหมาะสมสำหรับฟีเจอร์แต่ละรายการ

  • หากต้องการดูว่าผู้ใช้มีสิทธิ์เข้าถึงส่วนเสริมของ Classroom ที่เป็นของโปรเจ็กต์ Google Cloud ที่ส่งคำขอหรือไม่ ให้ส่งค่า CREATE_ADD_ON_ATTACHMENT
  • หากต้องการดูว่าผู้ใช้แก้ไขการตั้งค่าระยะเวลาการให้คะแนนได้หรือไม่ ให้ส่งผ่าน UPDATE_GRADING_PERIOD_SETTINGS

จากนั้นตรวจสอบช่อง allowed ในการตอบกลับ หาก allowed คือ true ผู้ใช้จะมีสิทธิ์เข้าถึง Capability ที่เลือก จากนั้นคุณจะส่งคําขอ API ที่เกี่ยวกับ Capability ในนามของผู้ใช้ได้