مدیریت دعوت نامه های دوره

یک منبع Invitation در Classroom نشان‌دهنده دعوتی برای یک کاربر برای پیوستن به یک دوره با نقش خاص دوره است: دانش‌آموز، معلم یا مالک.

هر منبع Invitation شامل فیلدهای زیر است:

  • id : شناسه‌ای که توسط کلاس برای دعوت‌نامه تعیین شده است.
  • userId : شناسه کاربری که به دوره دعوت شده است.
  • courseId : دوره‌ای که کاربر به آن دعوت شده است.
  • role : نقشی که کاربر دعوت‌شده در دوره خواهد داشت.

ایجاد دعوتنامه

متد invitations.create() می‌تواند برای دعوت یک کاربر به یک دوره با یک نقش خاص استفاده شود. منبع Invitation را در بدنه درخواست قرار دهید و courseId ، userId و role را مشخص کنید.

جاوا

کلاس/قطعه کد/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 دعوت، یک دعوتنامه خاص را بازیابی کنید.

جاوا

کلاس/قطعه قطعه/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 دعوت‌نامه را مشخص کنید.

جاوا

class/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 آن را مشخص کنید.

جاوا

کلاس/قطعه قطعه/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;
}