Gerenciar convites de curso

Um recurso Invitation no Google Sala de Aula representa um convite para um usuário participar de um curso com uma função específica: estudante, professor ou proprietário.

Cada recurso Invitation contém os seguintes campos:

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

Criar um convite

O método invitations.create() pode ser usado para convidar um usuário a um curso com uma função específica. Inclua o Invitation recurso no corpo da solicitação e especifique courseId, userId e role.

Java

classroom/snippets/src/main/java/CreateInvitation.java

Ver no GitHub

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

Recupere um convite específico chamando o método invitations.get() e especificando o id do convite.

Java

classroom/snippets/src/main/java/GetInvitation.java

Ver no GitHub

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, ele é excluído e o usuário convidado é adicionado ao curso com a função especificada no convite. Aceite um convite chamando o método invitations.accept() e especificando o id do convite.

Java

classroom/snippets/src/main/java/AcceptInvitation.java

Ver no GitHub

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 um novo. Para excluir o convite, chame o método invitations.delete() e especifique o id.

Java

classroom/snippets/src/main/java/DeleteInvitation.java

Ver no GitHub

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