Gerenciar convites do curso

Um recurso de convite no Google Sala de Aula representa um convite para um usuário participar de um curso com uma função específica.

Cada recurso de convite contém os seguintes campos:

  • id do convite atribuído pelo Google Sala de Aula.
  • userId do usuário para quem o convite foi enviado.
  • courseId do curso para o qual o usuário está sendo convidado.
  • role a função que o usuário convidado vai ter no curso.

Criar um convite

Crie um convite para que um usuário possa participar de um curso com o papel especificado chamando o método invitations.create(). Inclua o recurso de convite no corpo da solicitação e especifique courseId, userId e role.

Java

sala de aula/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;

Recuperar um convite

Para recuperar um convite específico, chame o método invitations.get() e especifique o id do convite.

Java

sala de aula/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;

Aceitar um convite

Ao aceitar um convite para um curso, ele é excluído e o usuário é adicionado ao curso com o papel especificado. Para aceitar um convite, chame o método invitations.accept() e especifique o id do convite.

Java

sala de aula/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;
}

Excluir um convite

A única maneira de atualizar um convite é excluí-lo e criar outro. Para excluir o convite, chame o método invitations.delete() e especifique o id.

Java

sala de aula/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;
}