Method: invitations.create

초대를 만듭니다. 사용자 및 강의당 한 번에 하나의 초대만 존재할 수 있습니다. 변경하려면 초대를 삭제한 후 다시 만드세요.

이 메서드는 다음 오류 코드를 반환합니다.

  • PERMISSION_DENIED 권한을 요청하는 사용자에게 이 강의에 대한 초대를 만들 수 없거나 액세스 오류가 있는 경우 초대를 만들 수 없습니다.
  • NOT_FOUND: 과정 또는 사용자가 존재하지 않는 경우
  • FAILED_PRECONDITION:
    • 요청된 사용자 계정이 사용 중지된 경우
    • 사용자에게 이미 이 역할 또는 더 높은 권한을 가진 역할이 있는 경우
    • 요청 오류:
      • IneligibleOwner
  • 지정된 사용자 및 과정에 대한 초대가 이미 있는 경우 ALREADY_EXISTS입니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에는 Invitation의 인스턴스가 포함됩니다.

응답 본문

성공한 경우 응답 본문에 새로 생성된 Invitation의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 승인 가이드를 참고하세요.