یک دعوت نامه ایجاد کنید تا کاربر بتواند با فراخوانی متد invitations.create() به دوره ای با نقش مشخص شده ملحق شود. منبع Invitation را در بدنه درخواست قرار دهید و courseId ، userId و role مشخص کنید.
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 دعوت نامه، یک دعوت نامه خاص را بازیابی کنید.
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 دعوت نامه، دعوت نامه را بپذیرید.
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 مشخص کنید.