Gérer les invitations à des cours

Une ressource d'invitation dans Classroom représente une invitation pour un utilisateur à rejoindre un cours avec un rôle de cours spécifique.

Chaque ressource Invitation contient les champs suivants:

  • id de l'invitation attribuée par Classroom.
  • userId de l'utilisateur auquel l'invitation est envoyée.
  • courseId du cours auquel l'utilisateur est invité.
  • role est le rôle attribué à l'utilisateur invité dans le cours.

Créer une invitation

Créez une invitation afin qu'un utilisateur puisse rejoindre un cours avec le rôle spécifié en appelant la méthode invitations.create(). Incluez la ressource Invitation dans le corps de la requête et spécifiez courseId, userId et role.

Java

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;

Récupérer une invitation

Récupérez une invitation spécifique en appelant la méthode invitations.get() et en spécifiant le id de l'invitation.

Java

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;

Accepter une invitation

Si vous acceptez une invitation à un cours, l'invitation est supprimée, et l'utilisateur est ajouté au cours avec le rôle spécifié dans l'invitation. Pour accepter une invitation, appelez la méthode invitations.accept() et spécifiez le id de l'invitation.

Java

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

Supprimer une invitation

Le seul moyen de mettre à jour une invitation consiste à la supprimer et à en créer une autre. Pour supprimer l'invitation, appelez la méthode invitations.delete() et spécifiez id.

Java

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