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

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

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

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

إنشاء دعوة

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

لغة Java

Classroom/snippets/src/main/java/CreateInvite.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/GetInvite.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/AcceptInvite.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/DeleteInvite.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;
}