Quản lý lời mời tham gia khoá học

Tài nguyên lời mời trong Lớp học là lời mời người dùng tham gia một khoá học với một vai trò trong khoá học cụ thể.

Mỗi tài nguyên Lời mời chứa các trường sau:

  • id của lời mời do Lớp học chỉ định.
  • userId của người dùng được gửi lời mời.
  • courseId của khoá học mà người dùng được mời tham gia.
  • role vai trò trong khoá học mà người dùng được mời sẽ có trong khoá học.

Tạo lời mời

Tạo lời mời để người dùng có thể tham gia khoá học với vai trò đã chỉ định bằng cách gọi phương thức invitations.create(). Đưa Tài nguyên lời mời vào nội dung yêu cầu và chỉ định courseId, userId và role.

Java

classroom/snippets/src/main/java/CreateInvitation.java
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;

Truy xuất lời mời

Truy xuất một lời mời cụ thể bằng cách gọi phương thức invitations.get() và chỉ định id của lời mời.

Java

classroom/snippets/src/main/java/GetInvitation.java
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;

Chấp nhận lời mời

Việc chấp nhận lời mời tham gia một khoá học sẽ xoá lời mời đó và thêm người dùng vào khoá học với vai trò được chỉ định trong lời mời. Chấp nhận lời mời bằng cách gọi phương thức invitations.accept() và chỉ định id của lời mời.

Java

classroom/snippets/src/main/java/AcceptInvitation.java
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;
}

Xoá lời mời

Cách duy nhất để cập nhật lời mời là xoá lời mời đó rồi tạo lời mời mới. Để xoá lời mời, hãy gọi phương thức invitations.delete() và chỉ định id.

Java

classroom/snippets/src/main/java/DeleteInvitation.java
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;
}