Kurseinladungen verwalten

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

Jede Einladungsressource enthält die folgenden Felder:

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

Einladung erstellen

Erstellen Sie eine Einladung, damit ein Nutzer einem Kurs mit der angegebenen Rolle beitreten kann, indem Sie 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

Rufen Sie die Methode invitations.get() auf und geben Sie die id der Einladung an, um eine bestimmte Einladung abzurufen.

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;

Einladung 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. Nehmen Sie eine Einladung an, indem Sie die Methode invitations.accept() aufrufen und die 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;
}

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