Classroom 中的 Invitation
資源代表邀請,邀請使用者以特定課程角色 (學生、老師或擁有者) 加入課程。
每個 Invitation
資源都包含下列欄位:
id
:邀請函的 Classroom 指派 ID。userId
:已受邀加入課程的使用者 ID。courseId
:使用者受邀加入的課程。role
:受邀使用者在課程中的課程角色。
建立邀請
您可以使用 invitations.create()
方法,邀請使用者加入課程並擔任特定角色。在要求主體中加入 Invitation
資源,並指定 courseId
、userId
和 role
。
Java
擷取邀請
呼叫 invitations.get()
方法,並指定邀請函的 id
,即可擷取特定邀請函。
Java
接受邀請
接受邀請後,系統會刪除邀請,並將受邀使用者加入課程,並指派邀請中指定的角色。呼叫 invitations.accept()
方法並指定邀請的 id
,即可接受邀請。
Java
刪除邀請
如要更新邀請,唯一的方法是刪除邀請,然後建立新的邀請。如要刪除邀請,請呼叫 invitations.delete()
方法,並指定 id
。