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

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

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

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

إنشاء دعوة

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

Java

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

عرض على GitHub

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

عرض على GitHub

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

عرض على GitHub

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

عرض على GitHub

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