Quản lý lời mời tham gia khóa học

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

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

  • id lời mời do Lớp học chỉ định.
  • userId người dùng nhận lời mời.
  • courseId của khoá học mà người dùng đang được mời tham gia.
  • role vai trò của 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 rồi chỉ định courseId, userId và role.

Java

lớp học/snippets/src/main/java/Create cận.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 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

lớp học/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 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

lớp học/snippets/src/main/java/ọcLời mời.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 một lời mời là xoá và tạo một 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

lớp học/snippets/src/main/java/Delete cận.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;
}