Каждый ресурс «Приглашение» содержит следующие поля:
id приглашения, назначенного Классом.
userId пользователя, которому отправлено приглашение.
courseId курса, на который приглашается пользователь.
roleроль курса , которую приглашенный пользователь будет иметь в курсе.
Создать приглашение
Создайте приглашение, чтобы пользователь мог присоединиться к курсу с указанной ролью, вызвав метод 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 .