강의 초대 관리

클래스룸의 초대 리소스는 사용자가 특정 과정 역할로 과정에 참여하도록 초대하는 것을 나타냅니다.

각 초대 리소스에는 다음 필드가 포함됩니다.

id 클래스룸에서 할당한 초대
초대가 전송된 사용자의 userId입니다.
사용자가 초대되는 과정의 courseId입니다.
role 초대된 사용자가 과정에 참여할 과정 역할입니다.

초대 만들기

사용자가 invitations.create() 메서드를 호출하여 지정된 역할로 과정에 참여할 수 있도록 초대를 만듭니다. 요청 본문에 초대 리소스를 포함하고 courseId, userId, role를 지정합니다.

자바

classroom/snippets/src/main/java/CreateInvitation.java

GitHub에서 보기

Invitation invitation = null;
try {
  /* Set the role the user is invited to have in the course. Possible values of CourseRole can be
  found here: https://developers.google.com/classroom/reference/rest/v1/invitations#courserole.*/
  Invitation content =
      new Invitation().setCourseId(courseId).setUserId(userId).setRole("TEACHER");

  invitation = service.invitations().create(content).execute();

  System.out.printf(
      "User (%s) has been invited to course (%s).\n",
      invitation.getUserId(), invitation.getCourseId());
} catch (GoogleJsonResponseException e) {
  // TODO (developer) - handle error appropriately
  GoogleJsonError error = e.getDetails();
  if (error.getCode() == 404) {
    System.out.printf("The course or user does not exist.\n");
  }
  throw e;
} catch (Exception e) {
  throw e;
}
return invitation;

초대 가져오기

invitations.get() 메서드를 호출하고 초대의 id를 지정하여 특정 초대를 검색합니다.

자바

classroom/snippets/src/main/java/GetInvitation.java

GitHub에서 보기

Invitation invitation = null;
try {
  invitation = service.invitations().get(id).execute();
  System.out.printf(
      "Invitation (%s) for user (%s) in course (%s) retrieved.\n",
      invitation.getId(), invitation.getUserId(), invitation.getCourseId());
} catch (GoogleJsonResponseException e) {
  GoogleJsonError error = e.getDetails();
  if (error.getCode() == 404) {
    System.out.printf("The invitation id (%s) does not exist.\n", id);
  }
  throw e;
} catch (Exception e) {
  throw e;
}
return invitation;

초대 수락하기

과정 초대를 수락하면 초대가 삭제되고 초대에 지정된 역할로 사용자가 과정에 추가됩니다. invitations.accept() 메서드를 호출하고 초대의 id를 지정하여 초대를 수락합니다.

자바

classroom/snippets/src/main/java/AcceptInvitation.java

GitHub에서 보기

try {
  service.invitations().accept(id).execute();
  System.out.printf("Invitation (%s) was accepted.\n", id);
} catch (GoogleJsonResponseException e) {
  GoogleJsonError error = e.getDetails();
  if (error.getCode() == 404) {
    System.out.printf("The invitation id (%s) does not exist.\n", id);
  }
  throw e;
} catch (Exception e) {
  throw e;
}

초대 삭제하기

초대를 업데이트하는 유일한 방법은 초대를 삭제하고 새 초대를 만드는 것입니다. 초대를 삭제하려면 invitations.delete() 메서드를 호출하고 id를 지정합니다.

자바

classroom/snippets/src/main/java/DeleteInvitation.java

GitHub에서 보기

try {
  service.invitations().delete(id).execute();
  System.out.printf("Invitation (%s) was deleted.\n", id);
} catch (GoogleJsonResponseException e) {
  GoogleJsonError error = e.getDetails();
  if (error.getCode() == 404) {
    System.out.printf("The invitation id (%s) does not exist.\n", id);
  }
  throw e;
} catch (Exception e) {
  throw e;
}

별칭 만들기 및 관리하기