Ders davetlerini yönetme

Classroom'daki Davet kaynağı, kullanıcının belirli bir ders rolüyle bir derse katılmasını sağlayan davetiyeyi temsil eder.

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

  • id Classroom tarafından atanan davetiyenin.
  • Davetiyenin gönderildiği kullanıcının userId.
  • courseId kullanıcının davet edildiği dersin
  • role davet edilen kullanıcının kurstaki kurs rolü.

Davet oluşturma

invitations.create() yöntemini çağırarak kullanıcıların belirtilen rolle bir derse katılabilmesi için 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;

Davetiyeyi alma

invitations.get() yöntemini çağırıp davetin id değerini belirterek belirli bir daveti 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;

Daveti Kabul Et

Bir kurs davetiyesi kabul edildiğinde davetiye silinir ve kullanıcı, davetiyede belirtilen rolle kursa eklenir. invitations.accept() yöntemini çağırarak ve davetin id değerini 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;
}

Davetiyeleri silme

Davetiyeleri güncellemenin tek yolu, davetiyeyi silip yeni bir davetiye oluşturmaktır. Davetiyeyi silmek için invitations.delete() yöntemini çağırın ve id değerini 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;
}