Ders davetlerini yönetme

Classroom'daki Invitation kaynağı, kullanıcının bir kursa belirli bir kurs rolüyle (öğrenci, öğretmen veya sahip) katılması için gönderilen davetiyeyi temsil eder.

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

• id: Davet için Classroom tarafından atanan tanımlayıcı.
• userId: Kursa davet edilen kullanıcının kimliği.
• courseId: Kullanıcının davet edildiği kurs.
• role: Davet edilen kullanıcının kurstaki kurs rolü.

Davet oluşturma

invitations.create() yöntemi, kullanıcıları belirli bir role sahip bir kursa davet etmek için kullanılabilir. Invitation kaynağını istek gövdesine ekleyin ve courseId, userId ve role değerlerini belirtin.

Java

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

GitHub'da göster

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

GitHub'da göster

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

Davetiye kabul edildiğinde davetiye silinir ve davet edilen 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

GitHub'da göster

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. Daveti silmek için invitations.delete() yöntemini çağırın ve id değerini belirtin.

Java

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

GitHub'da göster

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