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

Tài nguyên Invitation trong Lớp học đại diện cho lời mời người dùng tham gia một khoá học với vai trò trong khoá học cụ thể: học viên, giáo viên hoặc chủ sở hữu.

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

• id: Giá trị nhận dạng do Lớp học chỉ định cho lời mời.
• userId: Mã nhận dạng của người dùng đã được mời tham gia khoá học.
• courseId: 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

Bạn có thể dùng phương thức invitations.create() để mời người dùng tham gia một khoá học với một vai trò cụ thể. Thêm tài nguyên Invitation vào phần nội dung yêu cầu và chỉ định courseId, userId và role.

Java

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

Xem trên 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;

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

Xem trên 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;

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

Khi bạn chấp nhận lời mời, lời mời đó sẽ bị xoá và người dùng được mời sẽ được thêm 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

Xem trên 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;
}

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

Xem trên 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;
}