管理课程邀请

Classroom 中的 Invitation 资源表示邀请用户加入课程，并担任特定 课程角色（学生、教师或所有者）。

每个 Invitation 资源都包含以下字段：

  • id：Classroom 为邀请分配的标识符。
  • userId：已受邀加入课程的用户的 ID。
  • courseId：用户受邀加入的课程。
  • role：受邀用户在课程中担任的课程角色。

创建邀请

您可以使用 invitations.create() 方法邀请用户加入课程 ，并担任特定角色。在请求正文中添加 Invitation 资源 并指定 courseId、userId 和 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;

检索邀请

如需检索特定邀请，请调用 invitations.get() 方法 并指定邀请的 id。

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;

接受邀请

接受邀请会删除邀请，并将受邀用户添加到课程中，并担任邀请中指定的角色。如需接受邀请，请调用 invitations.accept() 方法并指定邀请的 id。

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

删除邀请

更新邀请的唯一方法是删除邀请并创建新邀请。如需删除邀请，请调用 invitations.delete() 方法 并指定 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;
}
上一页
创建和管理教师和学生
下一页
创建和管理监护人