Method: invitations.create

Tạo lời mời. Mỗi người dùng và khoá học chỉ có thể có một lời mời tại một thời điểm. Xoá và tạo lại lời mời để thực hiện thay đổi.

Phương thức này trả về các mã lỗi sau:

  • PERMISSION_DENIED nếu người dùng yêu cầu không được phép tạo lời mời cho khoá học này hoặc do lỗi truy cập.
  • NOT_FOUND nếu khoá học hoặc người dùng không tồn tại.
  • FAILED_PRECONDITION:
    • nếu tài khoản của người dùng được yêu cầu bị vô hiệu hoá.
    • nếu người dùng đã có vai trò này hoặc một vai trò có nhiều quyền hơn.
    • đối với các lỗi yêu cầu sau:
      • IneligibleOwner
  • ALREADY_EXISTS nếu đã có lời mời cho người dùng và khoá học được chỉ định.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của Invitation.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể Invitation mới tạo.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.