إدارة دعوات الدورات التدريبية

يمثّل مرجع الدعوة في Classroom دعوة لمستخدم للانضمام إلى دورة تدريبية من خلال دور دورة تدريبية محدّد.

يحتوي كلّ مورد Invitation على الحقول التالية:

  • id من الدعوة التي تحدّدها منصة Classroom.
  • userId للمستخدم الذي يتم إرسال الدعوة إليه.
  • courseId من الدورة التدريبية التي تتم دعوة المستخدم إليها.
  • role دور الدورة التدريبية الذي سيحصل عليه المستخدم المدعو في الدورة التدريبية

إنشاء دعوة

أنشئ دعوة ليتمكن المستخدم من الانضمام إلى دورة دراسية بالدور المحدّد من خلال استدعاء طريقة invitations.create(). أدرِج مرجع الدعوة في نص الطلب وحدِّد courseId وuserId وrole.

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;

استرداد دعوة

يمكنك استرداد دعوة معيّنة من خلال استدعاء الطريقة invitations.get() وتحديد id الدعوة.

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;

قبول دعوة

يؤدي قبول دعوة إلى دورة تدريبية إلى حذف الدعوة وإضافة المستخدم إلى الدورة التدريبية بالدور المحدّد في الدعوة. قبول دعوة من خلال استدعاء الطريقة invitations.accept() وتحديد id للدعوة

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

حذف دعوة

إنّ الطريقة الوحيدة لتعديل دعوة هي حذفها وإنشاء دعوة جديدة. لحذف الدعوة، استخدِم الطريقة invitations.delete() وحدِّد id.

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