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

یک منبع دعوت در Classroom نشان دهنده دعوتی برای کاربر برای پیوستن به یک دوره با یک نقش دوره خاص است.

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

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

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

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

جاوا

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

جاوا

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 دعوت نامه، دعوت نامه را بپذیرید.

جاوا

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 مشخص کنید.

جاوا

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