مدیریت دعوت نامه های دوره

یک منبع Invitation در Classroom دعوتی برای کاربر برای پیوستن به دوره ای با نقش درسی خاص است: دانش آموز، معلم یا مالک.

هر منبع Invitation شامل فیلدهای زیر است:

  • id : شناسه اختصاص داده شده به کلاس برای دعوتنامه.
  • userId : شناسه کاربری که به دوره دعوت شده است.
  • courseId : دوره ای که کاربر به آن دعوت شده است.
  • role : نقش دوره ای که کاربر دعوت شده در دوره خواهد داشت.

یک دعوت نامه ایجاد کنید

متد invitations.create() می تواند برای دعوت کاربر به دوره ای با یک نقش خاص استفاده شود. منبع Invitation را در بدنه درخواست قرار دهید و courseId ، userId و role مشخص کنید.

جاوا

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 دعوت نامه، یک دعوت نامه خاص را بازیابی کنید.

جاوا

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 دعوت نامه، دعوت نامه را بپذیرید.

جاوا

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 را مشخص کنید.

جاوا

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

یک منبع Invitation در Classroom دعوتی برای کاربر برای پیوستن به دوره ای با نقش درسی خاص است: دانش آموز، معلم یا مالک.

هر منبع Invitation شامل فیلدهای زیر است:

  • id : شناسه اختصاص داده شده به کلاس برای دعوتنامه.
  • userId : شناسه کاربری که به دوره دعوت شده است.
  • courseId : دوره ای که کاربر به آن دعوت شده است.
  • role : نقش دوره ای که کاربر دعوت شده در دوره خواهد داشت.

یک دعوت نامه ایجاد کنید

متد invitations.create() می تواند برای دعوت کاربر به دوره ای با یک نقش خاص استفاده شود. منبع Invitation را در بدنه درخواست قرار دهید و courseId ، userId و role مشخص کنید.

جاوا

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 دعوت نامه، یک دعوت نامه خاص را بازیابی کنید.

جاوا

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 دعوت نامه، دعوت نامه را بپذیرید.

جاوا

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 را مشخص کنید.

جاوا

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