Method: invitations.create

초대를 만듭니다. 사용자 및 과정에 대한 초대는 한 번에 하나만 존재할 수 있습니다. 초대를 삭제하고 다시 만들어 변경합니다.

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

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

HTTP 요청

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

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

요청 본문

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

응답 본문

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

승인 범위

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

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

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