ניהול הזמנות לקורסים

משאב הזמנה ב-Classroom מייצג הזמנה למשתמש להצטרף לקורס עם תפקיד ספציפי בקורס.

כל משאב Invitation מכיל את השדות הבאים:

• id של ההזמנה שהוקצתה על ידי Classroom.
• userId של המשתמש שאליו נשלחת ההזמנה.
• courseId של הקורס שאליו המשתמש מוזמן.
• role את תפקיד הקורס שיהיה למשתמש המוזמן בקורס.

יצירת הזמנה

כדי ליצור הזמנה שמאפשרת למשתמש להצטרף לקורס בתפקיד שצוין, צריך להפעיל את השיטה invitations.create(). כוללים את משאב ההזמנה בגוף הבקשה ומציינים את הערכים של 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;

אחזור הזמנה

כדי לאחזר הזמנה ספציפית, צריך לקרוא ל-method‏ 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;
}

מחיקת הזמנה

הדרך היחידה לעדכן הזמנה היא למחוק אותה וליצור הזמנה חדשה. כדי למחוק את ההזמנה, צריך לבצע קריאה ל-method‏ 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;
}