จัดการคําเชิญของหลักสูตร

แหล่งข้อมูลเกี่ยวกับคำเชิญใน Classroom เป็นเหมือนคำเชิญให้ผู้ใช้เข้าร่วมหลักสูตรโดยใช้บทบาทของหลักสูตรที่เจาะจง

ทรัพยากรของคำเชิญแต่ละรายการจะมีช่องต่อไปนี้

  • id ของคำเชิญที่มอบหมายโดย Classroom
  • userId ของผู้ใช้ที่ได้รับคําเชิญ
  • courseId ของหลักสูตรที่ผู้ใช้ได้รับเชิญให้เข้าร่วม
  • role บทบาทของหลักสูตรที่ผู้ใช้ที่ได้รับเชิญจะมีในหลักสูตร

สร้างคำเชิญ

สร้างคำเชิญเพื่อให้ผู้ใช้เข้าร่วมหลักสูตรด้วยบทบาทที่ระบุได้โดยเรียกใช้เมธอด invitations.create() รวมแหล่งข้อมูลคำเชิญไว้ในเนื้อหาของคำขอ และระบุ 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/ยอมรับคำเชิญ.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;
}