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

詳情請參閱授權指南