Google Classroom 外掛程式現已全面開放開發人員使用!詳情請參閱
外掛程式說明文件。
Method: courses.teachers.create
建立課程老師。
網域管理員可以直接將網域中的使用者新增為網域課程的老師。非管理員使用者應改為傳送 Invitation
。
這個方法會傳回下列錯誤代碼:
PERMISSION_DENIED
如果要求使用者未獲准在課程中建立老師,或因存取錯誤而發生。
NOT_FOUND
:如果要求的課程 ID 不存在。
FAILED_PRECONDITION
如果要求的使用者帳戶已停用,則會發生以下要求錯誤:
- CourseMemberLimitReached
- CourseNotModifiable
- CourseTeacherLimitReached
- UserGroupsMembershipLimitReached
- InactiveCourseOwner
ALREADY_EXISTS
如果使用者已是課程的老師或學生。
HTTP 要求
POST https://classroom.googleapis.com/v1/courses/{courseId}/teachers
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
courseId |
string
課程的 ID。這個 ID 可以是 Classroom 指派的 ID 或 alias 。
|
回應主體
如果成功,回應主體會包含新建立的 Teacher
例項。
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/classroom.rosters
https://www.googleapis.com/auth/classroom.profile.emails
https://www.googleapis.com/auth/classroom.profile.photos
詳情請參閱授權指南。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-12-05 (世界標準時間)。
[null,null,["上次更新時間:2024-12-05 (世界標準時間)。"],[[["Creates a teacher for a specified course, allowing domain administrators to directly add users and non-admins to send invitations."],["Returns errors like `PERMISSION_DENIED`, `NOT_FOUND`, `FAILED_PRECONDITION`, and `ALREADY_EXISTS` based on user permissions and course status."],["Requires a `POST` request to the specified URL with the course ID as a path parameter."],["The request body should contain a `Teacher` object and a successful response will return the newly created `Teacher` object."],["Requires specific authorization scopes for access, including `classroom.rosters`, `classroom.profile.emails`, and `classroom.profile.photos`."]]],[]]