Ders davetlerini yönetme

Classroom'daki Invitation kaynağı, kullanıcıların belirli bir kurs rolü (öğrenci, öğretmen veya sahip) ile bir 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 parametrelerini 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 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 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
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
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;
}
Önceki
Öğretmen ve öğrenci oluşturma ve yönetme
Sonraki
Veli oluşturma ve yönetme