Ders davetlerini yönetme

Classroom'daki Invitation kaynağı, kullanıcıların belirli bir kurs rolü (öğrenci, öğretmen veya sahip) ile kursa katılma davetini temsil eder.

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

• id: Davetiye 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 kursta sahip olacağı kurs rolü.

Davetiye oluşturma

invitations.create() yöntemi, belirli bir role sahip bir kullanıcıyı kursa davet etmek için kullanılabilir. İstek gövdesine Invitation kaynağını 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;

Daveti kabul etme

Daveti kabul ettiğinizde davet silinir ve davet edilen kullanıcı, davette belirtilen rolle kursa eklenir. invitations.accept() yöntemini çağırıp 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;
}

Davetiyeyi silme

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