Gestire gli inviti ai corsi

Una risorsa di invito in Classroom rappresenta un invito a partecipare a un corso con uno specifico ruolo.

Ogni risorsa Invito contiene i seguenti campi:

  • id dell'invito assegnato da Classroom.
  • userId dell'utente a cui viene inviato l'invito.
  • courseId del corso a cui l'utente viene invitato.
  • role il ruolo del corso che l'utente invitato avrà durante il corso.

Crea un invito

Crea un invito in modo che un utente possa partecipare a un corso con il ruolo specificato chiamando il metodo invitations.create(). Includi la risorsa dell'invito nel corpo della richiesta e specifica courseId, userId e role.

Java

classroom/snippets/src/main/java/CreateInvito.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;

Recupera un invito

Recupera un invito specifico chiamando il metodo invitations.get() e specificando il id dell'invito.

Java

classroom/snippets/src/main/java/GetInvito.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;

Accetta un invito

Se accetti un invito a un corso, l'invito viene eliminato e l'utente viene aggiunto al corso con il ruolo specificato nell'invito. Accetta un invito chiamando il metodo invitations.accept() e specificando il id dell'invito.

Java

classroom/snippets/src/main/java/AccettaInvito.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;
}

Elimina un invito

L'unico modo per aggiornare un invito è eliminarlo e crearne uno nuovo. Per eliminare l'invito, chiama il metodo invitations.delete() e specifica id.

Java

classroom/snippets/src/main/java/DeleteInvito.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;
}