เลือกขอบเขต Google Classroom API

เอกสารนี้มีข้อมูลการให้สิทธิ์และ การตรวจสอบสิทธิ์สำหรับ 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