管理課程邀請

Classroom 中的 Invitation 資源代表邀請使用者以特定課程角色 (學生、老師或擁有者) 加入課程。

每個 Invitation 資源都包含下列欄位：

• id：邀請活動的 Classroom 指派 ID。
• userId：已受邀加入課程的使用者 ID。
• courseId：使用者受邀參加的課程。
• role：受邀使用者在課程中的課程角色。

建立邀請

您可以使用 invitations.create() 方法，邀請使用者加入課程並擔任特定角色。在要求主體中加入 Invitation 資源，並指定 courseId、userId 和 role。

Java

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，即可擷取特定邀請函。

Java

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，即可接受邀請。

Java

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。

Java

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