이제 Google 클래스룸 부가기능이 일반적으로 개발자에게 제공됩니다. 자세한 내용은
부가기능 문서를 참고하세요.
REST Resource: invitations
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
리소스: 초대
JSON 표현 |
{
"id": string,
"userId": string,
"courseId": string,
"role": enum (CourseRole )
} |
필드 |
id |
string
클래스룸에서 할당한 식별자입니다. 읽기 전용입니다.
|
userId |
string
초대된 사용자의 식별자입니다. 요청의 매개변수로 지정된 경우 이 식별자는 다음 중 하나로 설정할 수 있습니다.
- 사용자의 숫자 식별자
- 사용자의 이메일 주소
- 요청하는 사용자를 나타내는 문자열 리터럴
"me"
|
courseId |
string
사용자를 초대할 수업의 식별자입니다.
|
role |
enum (CourseRole )
사용자에게 부여할 역할입니다. COURSE_ROLE_UNSPECIFIED 이 아니어야 합니다.
|
CourseRole
열거형 |
COURSE_ROLE_UNSPECIFIED |
수업 역할이 없습니다. |
STUDENT |
과정에 참여 중인 학생 |
TEACHER |
과정의 교사입니다. |
OWNER |
과정 소유자입니다. |
메서드 |
|
초대를 수락하여 삭제하고 초대된 사용자를 지정된 과정의 교사 또는 학생 (해당하는 경우)에 추가합니다. |
|
초대를 만듭니다. |
|
초대를 삭제합니다. |
|
초대를 반환합니다. |
|
요청하는 사용자가 볼 수 있는 초대 목록을 반환하며, 목록 요청과 일치하는 초대로 제한됩니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[],[],null,["# REST Resource: invitations\n\n- [Resource: Invitation](#Invitation)\n - [JSON representation](#Invitation.SCHEMA_REPRESENTATION)\n- [CourseRole](#CourseRole)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Invitation\n--------------------\n\nAn invitation to join a course.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"id\": string, \"userId\": string, \"courseId\": string, \"role\": enum (/workspace/classroom/reference/rest/v1/invitations#CourseRole) } ``` |\n\n| Fields ||\n|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `id` | `string` Identifier assigned by Classroom. Read-only. |\n| `userId` | `string` Identifier of the invited user. When specified as a parameter of a request, this identifier can be set to one of the following: - the numeric identifier for the user - the email address of the user - the string literal `\"me\"`, indicating the requesting user |\n| `courseId` | `string` Identifier of the course to invite the user to. |\n| `role` | `enum (`[CourseRole](/workspace/classroom/reference/rest/v1/invitations#CourseRole)`)` Role to invite the user to have. Must not be `COURSE_ROLE_UNSPECIFIED`. |\n\nCourseRole\n----------\n\nPossible roles a user may be invite to have.\n\n| Enums ||\n|---------------------------|------------------------|\n| `COURSE_ROLE_UNSPECIFIED` | No course role. |\n| `STUDENT` | Student in the course. |\n| `TEACHER` | Teacher of the course. |\n| `OWNER` | Owner of the course. |\n\n| Methods ------- ||\n|-------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|\n| ### [accept](/workspace/classroom/reference/rest/v1/invitations/accept) | Accepts an invitation, removing it and adding the invited user to the teachers or students (as appropriate) of the specified course. |\n| ### [create](/workspace/classroom/reference/rest/v1/invitations/create) | Creates an invitation. |\n| ### [delete](/workspace/classroom/reference/rest/v1/invitations/delete) | Deletes an invitation. |\n| ### [get](/workspace/classroom/reference/rest/v1/invitations/get) | Returns an invitation. |\n| ### [list](/workspace/classroom/reference/rest/v1/invitations/list) | Returns a list of invitations that the requesting user is permitted to view, restricted to those that match the list request. |"]]