เอกสารนี้มีข้อมูลการให้สิทธิ์และ การตรวจสอบสิทธิ์สำหรับ Google Classroom API โดยเฉพาะ ก่อนอ่านเอกสารนี้ โปรดอ่านข้อมูลการตรวจสอบสิทธิ์และการให้สิทธิ์ทั่วไปของ Google Workspace ที่ดูข้อมูลเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์
กำหนดค่า OAuth 2.0 สำหรับการให้สิทธิ์
กำหนดค่าหน้าจอคำยินยอม OAuth และเลือกขอบเขตเพื่อกำหนดข้อมูลที่แสดงต่อผู้ใช้และผู้ตรวจสอบแอป รวมถึงลงทะเบียนแอปเพื่อให้เผยแพร่ได้ในภายหลัง
ขอบเขต Classroom API
หากต้องการกำหนดระดับการเข้าถึงที่กำหนดให้กับแอป คุณต้องระบุและประกาศขอบเขตการให้สิทธิ์ ขอบเขตการให้สิทธิ์คือสตริง URI ของ OAuth 2.0 ที่มีชื่อแอป Google Workspace, ประเภทข้อมูลที่เข้าถึง และระดับการเข้าถึง ขอบเขตคือคำขอการทำงานของแอปกับข้อมูล Google Workspace ซึ่งรวมถึงข้อมูลบัญชี Google ของผู้ใช้
เมื่อติดตั้งแอปแล้ว ระบบจะขอให้ผู้ใช้ตรวจสอบขอบเขตที่แอปใช้ โดยทั่วไปคุณควรเลือกขอบเขตที่เจาะจงที่สุดเท่าที่จะทำได้ และหลีกเลี่ยงการขอขอบเขตที่แอปไม่จำเป็นต้องใช้ ผู้ใช้พร้อมจะให้สิทธิ์เข้าถึงขอบเขตที่จำกัดและอธิบายไว้อย่างชัดเจนมากกว่า
Classroom API รองรับขอบเขตต่อไปนี้
ขอบเขต | ความหมาย |
---|---|
https://www.googleapis.com/auth/classroom.announcements
|
ดูและจัดการประกาศใน Google Classroom |
https://www.googleapis.com/auth/classroom.announcements.readonly
|
ดูประกาศใน Google Classroom |
https://www.googleapis.com/auth/classroom.courses
|
ดู แก้ไข สร้าง และลบชั้นเรียนใน Google Classroom อย่างถาวร |
https://www.googleapis.com/auth/classroom.courses.readonly
|
ดูชั้นเรียน Google Classroom |
https://www.googleapis.com/auth/classroom.coursework.me
|
ดู สร้าง และแก้ไขงานต่างๆ ในคอร์สเรียน เช่น งาน คำถาม และคะแนน |
https://www.googleapis.com/auth/classroom.coursework.me.readonly
|
ดูการบ้านและรายงานและคะแนนใน Google Classroom |
https://www.googleapis.com/auth/classroom.coursework.students
|
จัดการการบ้านและรายงานและคะแนนสำหรับนักเรียนในชั้นเรียน Google Classroom ที่คุณสอน และดูการบ้านและรายงานและคะแนนสำหรับชั้นเรียนที่คุณ จัดการ |
https://www.googleapis.com/auth/classroom.coursework.students.readonly
|
ดูการบ้านและรายงานและคะแนนของนักเรียนในชั้นเรียน Google Classroom ที่คุณสอนหรือดูแล |
https://www.googleapis.com/auth/classroom.courseworkmaterials
|
ดู แก้ไข และสร้างสื่อสำหรับงานของชั้นเรียนใน Google Classroom |
https://www.googleapis.com/auth/classroom.courseworkmaterials.readonly
|
ดูสื่อสำหรับทุกงานของชั้นเรียน Google Classroom |
https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly
|
ดูผู้ปกครอง Google Classroom ของคุณ |
https://www.googleapis.com/auth/classroom.guardianlinks.students
|
ดูและจัดการผู้ปกครองนักเรียนในชั้นเรียน Google Classroom |
https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly
|
ดูผู้ปกครองนักเรียนในชั้นเรียน Google Classroom |
https://www.googleapis.com/auth/classroom.profile.emails
|
ดูอีเมลของคนในชั้นเรียนของคุณ |
https://www.googleapis.com/auth/classroom.profile.photos
|
ดูรูปโปรไฟล์ของคนในชั้นเรียน |
https://www.googleapis.com/auth/classroom.push-notifications
|
รับการแจ้งเตือนเกี่ยวกับข้อมูล Google Classroom |
https://www.googleapis.com/auth/classroom.rosters
|
จัดการบัญชีรายชื่อชั้นเรียนใน Google Classroom |
https://www.googleapis.com/auth/classroom.rosters.readonly
|
ดูบัญชีรายชื่อชั้นเรียนใน Google Classroom |
https://www.googleapis.com/auth/classroom.student-submissions.me.readonly
|
ดูการบ้านและรายงานและคะแนนใน Google Classroom |
https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
|
ดูการบ้านและรายงานและคะแนนของนักเรียนในชั้นเรียน Google Classroom ที่คุณสอนหรือดูแล |
https://www.googleapis.com/auth/classroom.topics
|
ดู สร้าง และแก้ไขหัวข้อใน Google Classroom |
https://www.googleapis.com/auth/classroom.topics.readonly
|
ดูหัวข้อใน Google Classroom |