Ders Davetiyelerini Yönetme

Classroom'daki davet kaynağı, kullanıcının belirli bir kurs rolüyle derse katılması için gönderilen daveti temsil eder.

Her Davetiye kaynağı aşağıdaki alanları içerir:

  • Classroom tarafından atanan davetiyenin id kadarı.
  • Davetiyenin gönderildiği kullanıcının userId kadarı.
  • Kullanıcının davet edildiği dersin courseId.
  • Davet edilen kullanıcının derste sahip olacağı kurs rolüne role.

Davetiye Oluşturun

Kullanıcıların invitations.create() yöntemini çağırarak belirtilen rolle bir derse katılabilmesi için bir davetiye oluşturun. Davetiye kaynağını istek gövdesine ekleyin ve courseId, userId ve role değerlerini belirtin.

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;

Davetiye Alma

invitations.get() yöntemini çağırıp davetin id özelliğini belirterek belirli bir davetiyeyi alın.

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;

Davetiyeyi Kabul Etme

Bir ders davetiyesini kabul ettiğinizde davetiye silinir ve kullanıcı davetiyede belirtilen role sahip derse eklenir. invitations.accept() yöntemini çağırıp davetin id adresini belirterek daveti kabul edin.

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

Davetiyeyi Silme

Bir davetiyeyi güncellemenin tek yolu, o davetiyeyi silmek ve yeni bir davetiye oluşturmaktır. Davetiyeyi silmek için invitations.delete() yöntemini çağırın ve id özelliğini belirtin.

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