Method: invitations.create

建立邀請。使用者和課程一次只能存在一個邀請。刪除邀請並重新建立，即可進行變更。

這個方法會傳回下列錯誤代碼：

  • PERMISSION_DENIED 如果要求使用者未獲准為此課程建立邀請，或因存取錯誤而發生。
  • NOT_FOUND，如果課程或使用者不存在。
  • FAILED_PRECONDITION：
    • 要求的使用者帳戶是否已停用。
    • 如果使用者已擁有此角色或權限更高的角色。
    • 針對以下要求錯誤：
      • IneligibleOwner
  • ALREADY_EXISTS：如果已為指定使用者和課程建立邀請。

HTTP 要求

POST https://classroom.googleapis.com/v1/invitations

這個網址使用 gRPC 轉碼語法。

要求主體

要求主體包含 Invitation 的例項。

回應主體

如果成功，回應主體會包含新建立的 Invitation 例項。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/classroom.rosters

詳情請參閱授權指南。