Kelola Undangan Kursus

Resource Invitation di Classroom mewakili undangan bagi pengguna untuk bergabung ke kursus dengan peran kursus tertentu: siswa, pengajar, atau pemilik.

Setiap resource Invitation berisi kolom berikut:

  • id: ID yang ditetapkan Classroom untuk undangan.
  • userId: ID pengguna yang telah diundang ke kursus.
  • courseId: Kursus yang diundang pengguna.
  • role: Peran kursus yang akan dimiliki pengguna yang diundang dalam kursus.

Membuat Undangan

Metode invitations.create() dapat digunakan untuk mengundang pengguna ke kursus dengan peran tertentu. Sertakan resource Invitation dalam isi permintaan dan tentukan courseId, userId, dan 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;

Mengambil Undangan

Ambil undangan tertentu dengan memanggil metode invitations.get() dan menentukan id undangan.

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;

Menerima Undangan

Menerima undangan akan menghapus undangan dan menambahkan pengguna yang diundang ke kursus dengan peran yang ditentukan dalam undangan. Terima undangan dengan memanggil metode invitations.accept() dan menentukan id undangan.

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;
}

Menghapus Undangan

Satu-satunya cara untuk memperbarui undangan adalah dengan menghapusnya dan membuat undangan baru. Untuk menghapus undangan, panggil metode invitations.delete() dan tentukan 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;
}
Sebelumnya
Membuat & mengelola pengajar & siswa
Berikutnya
Membuat & mengelola wali