Kurseinladungen verwalten

Eine Einladungsressource in Classroom ist eine Einladung an einen Nutzer, einem Kurs mit einer bestimmten Kursrolle beizutreten.

Jede Einladungsressource enthält die folgenden Felder:

  • id der Einladung, die von Classroom zugewiesen wurde.
  • userId des Nutzers, an den die Einladung gesendet wird.
  • courseId des Kurses, zu dem der Nutzer eingeladen wird.
  • role ist die Kursrolle, die der eingeladene Nutzer im Kurs haben wird.

Einladung erstellen

Erstellen Sie eine Einladung, damit ein Nutzer einem Kurs mit der angegebenen Rolle beitreten kann. Dazu muss er die Methode invitations.create() aufrufen. Fügen Sie die Einladungsressource in den Anfragetext ein und geben Sie courseId, userId und role an.

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;

Einladung abrufen

Sie können eine bestimmte Einladung abrufen, indem Sie die Methode invitations.get() aufrufen und id der Einladung angeben.

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;

Einladungen annehmen

Wenn Sie eine Einladung zu einem Kurs annehmen, wird die Einladung gelöscht und der Nutzer wird dem Kurs mit der in der Einladung angegebenen Rolle hinzugefügt. Sie können eine Einladung annehmen, indem Sie die Methode invitations.accept() aufrufen und id der Einladung angeben.

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

Einladungen löschen

Sie können eine Einladung nur aktualisieren, indem Sie sie löschen und eine neue Einladung erstellen. Wenn Sie die Einladung löschen möchten, rufen Sie die Methode invitations.delete() auf und geben Sie id an.

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