Создание опекунов и управление ими

Ресурс Guardian представляет пользователя, например родителя, который получает информацию о курсах и курсовой работе учащегося. Опекуна, который обычно не является участником домена Класса учащегося, необходимо пригласить, используя его адрес электронной почты.

Приглашения представлены ресурсом GuardianInvitation . Приглашенный пользователь получит электронное письмо с предложением принять приглашение. Если адрес электронной почты не связан с учетной записью Google, пользователю будет предложено создать ее, прежде чем принять приглашение.

Когда пользователь приглашен и до того, как он примет приглашение, GuardianInvitation имеет состояние PENDING . Как только пользователь принимает приглашение, GuardianInvitation помечается как COMPLETED и создается ресурс Guardian .

Состояние GuardianInvitation также может быть изменено на COMPLETED , если срок его действия истек или авторизованный пользователь отменяет приглашение (например, с помощью метода PatchGuardianInvitation ). Отношения опекуна также могут быть разорваны опекуном, учителем Класса или администратором с помощью веб-приложения Класса или метода DeleteGuardian .

Кто может управлять опекунами

В следующей таблице описаны действия, которые можно выполнить в отношении опекунов, в зависимости от типа аутентифицированного пользователя:

Таблица списков ACL, связанных с опекуном, по типам пользователей

Области применения

Существует три области, позволяющие управлять опекунами:

  • https://www.googleapis.com/auth/classroom.guardianlinks.me.readonly : просмотр собственных опекунов пользователя.
  • https://www.googleapis.com/auth/classroom.guardianlinks.students.readonly : просмотр опекунов и приглашений опекунов для учащихся, которых пользователь преподает или администрирует.
  • https://www.googleapis.com/auth/classroom.guardianlinks.students : просмотр и управление приглашениями опекунов и опекунов для учащихся, которых преподает или администрирует пользователь.

Общие действия

В этом разделе описаны некоторые распространенные действия опекуна, которые вы, возможно, захотите выполнить с помощью API Google Classroom.

Создать приглашение опекуна

В следующем примере показано, как создать приглашение опекуна с помощью метода userProfiles.guardianInvitations.create() :

Ява Питон
класс/фрагменты/src/main/java/CreateGuardianInvitation.java
GuardianInvitation guardianInvitation = null;

/* Create a GuardianInvitation object with state set to PENDING. See
https://developers.google.com/classroom/reference/rest/v1/userProfiles.guardianInvitations#guardianinvitationstate
for other possible states of guardian invitations. */
GuardianInvitation content =
    new GuardianInvitation()
        .setStudentId(studentId)
        .setInvitedEmailAddress(guardianEmail)
        .setState("PENDING");
try {
  guardianInvitation =
      service.userProfiles().guardianInvitations().create(studentId, content).execute();

  System.out.printf("Invitation created: %s\n", guardianInvitation.getInvitationId());
} catch (GoogleJsonResponseException e) {
  // TODO (developer) - handle error appropriately
  GoogleJsonError error = e.getDetails();
  if (error.getCode() == 404) {
    System.out.printf("There is no record of studentId: %s", studentId);
  } else {
    throw e;
  }
} catch (Exception e) {
  throw e;
}
return guardianInvitation;
guardianInvitation = {
  'invitedEmailAddress': 'guardian@gmail.com',
}
guardianInvitation = service.userProfiles().guardianInvitations().create(
                      studentId='student@mydomain.edu',
                          body=guardianInvitation).execute()
print("Invitation created with id: {0}".format(guardianInvitation.get('invitationId')))

Ответ включает присвоенный сервером идентификатор, который можно использовать для ссылки на GuardianInvitation .

Отменить приглашение опекуна

Чтобы отменить приглашение, измените состояние приглашения с PENDING на COMPLETE , вызвав метод userProfiles.guardianInvitations.patch() . Это единственный способ удалить приглашение.

Ява Питон
класс/фрагменты/src/main/java/CancelGuardianInvitation.java
GuardianInvitation guardianInvitation = null;

try {
  /* Change the state of the GuardianInvitation from PENDING to COMPLETE. See
  https://developers.google.com/classroom/reference/rest/v1/userProfiles.guardianInvitations#guardianinvitationstate
  for other possible states of guardian invitations. */
  GuardianInvitation content =
      service.userProfiles().guardianInvitations().get(studentId, invitationId).execute();
  content.setState("COMPLETE");

  guardianInvitation =
      service
          .userProfiles()
          .guardianInvitations()
          .patch(studentId, invitationId, content)
          .set("updateMask", "state")
          .execute();

  System.out.printf(
      "Invitation (%s) state set to %s\n.",
      guardianInvitation.getInvitationId(), guardianInvitation.getState());
} catch (GoogleJsonResponseException e) {
  // TODO (developer) - handle error appropriately
  GoogleJsonError error = e.getDetails();
  if (error.getCode() == 404) {
    System.out.printf(
        "There is no record of studentId (%s) or invitationId (%s).", studentId, invitationId);
  } else {
    throw e;
  }
} catch (Exception e) {
  throw e;
}
return guardianInvitation;
guardian_invite = {
     'state': 'COMPLETE'
}
guardianInvitation = service.userProfiles().guardianInvitations().patch(
  studentId='student@mydomain.edu',
  invitationId=1234, # Replace with the invitation ID of the invitation you want to cancel
  updateMask='state',
  body=guardianInvitation).execute()

Список приглашений для конкретного учащегося

Вы можете получить список всех приглашений, отправленных конкретному студенту, с помощью метода userProfiles.guardianInvitations.list() . По умолчанию будут возвращены только PENDING приглашения. Администратор домена также может получать приглашения в состоянии COMPLETED , указав параметр states .

Ява Питон
класс/фрагменты/src/main/java/ListGuardianInvitationsByStudent.java
List<GuardianInvitation> guardianInvitations = new ArrayList<>();
String pageToken = null;

try {
  do {
    ListGuardianInvitationsResponse response =
        service
            .userProfiles()
            .guardianInvitations()
            .list(studentId)
            .setPageToken(pageToken)
            .execute();

    /* Ensure that the response is not null before retrieving data from it to avoid errors. */
    if (response.getGuardianInvitations() != null) {
      guardianInvitations.addAll(response.getGuardianInvitations());
      pageToken = response.getNextPageToken();
    }
  } while (pageToken != null);

  if (guardianInvitations.isEmpty()) {
    System.out.println("No guardian invitations found.");
  } else {
    for (GuardianInvitation invitation : guardianInvitations) {
      System.out.printf("Guardian invitation id: %s\n", invitation.getInvitationId());
    }
  }
} catch (GoogleJsonResponseException e) {
  GoogleJsonError error = e.getDetails();
  if (error.getCode() == 404) {
    System.out.printf("There is no record of studentId (%s).", studentId);
  } else {
    throw e;
  }
} catch (Exception e) {
  throw e;
}
return guardianInvitations;
guardian_invites = []
page_token = None

while True:
    response = service.userProfiles().guardianInvitations().list(
                                      studentId='student@mydomain.edu').execute()
    guardian_invites.extend(response.get('guardian_invites', []))
    page_token = response.get('nextPageToken', None)
    if not page_token:
        break

if not courses:
    print('No guardians invited for this {0}.'.format(response.get('studentId')))
else:
    print('Guardian Invite:')
    for guardian in guardian_invites:
        print('An invite was sent to '.format(guardian.get('id'),
                                              guardian.get('guardianId')))

Список активных опекунов

Чтобы определить, какие пользователи являются активными опекунами конкретного учащегося, используйте метод userProfiles.guardians.list() . Активные опекуны — это опекуны, принявшие приглашение.

Ява Питон
класс/фрагменты/src/main/java/ListGuardians.java
List<Guardian> guardians = new ArrayList<>();
String pageToken = null;

try {
  do {
    ListGuardiansResponse response =
        service.userProfiles().guardians().list(studentId).setPageToken(pageToken).execute();

    /* Ensure that the response is not null before retrieving data from it to avoid errors. */
    if (response.getGuardians() != null) {
      guardians.addAll(response.getGuardians());
      pageToken = response.getNextPageToken();
    }
  } while (pageToken != null);

  if (guardians.isEmpty()) {
    System.out.println("No guardians found.");
  } else {
    for (Guardian guardian : guardians) {
      System.out.printf(
          "Guardian name: %s, guardian id: %s, guardian email: %s\n",
          guardian.getGuardianProfile().getName().getFullName(),
          guardian.getGuardianId(),
          guardian.getInvitedEmailAddress());
    }
  }

} catch (GoogleJsonResponseException e) {
  GoogleJsonError error = e.getDetails();
  if (error.getCode() == 404) {
    System.out.printf("There is no record of studentId (%s).", studentId);
  } else {
    throw e;
  }
} catch (Exception e) {
  throw e;
}
return guardians;
guardian_invites = []
page_token = None

while True:
    response = service.userProfiles().guardians().list(studentId='student@mydomain.edu').execute()
    guardian_invites.extend(response.get('guardian_invites', []))
    page_token = response.get('nextPageToken', None)
    if not page_token:
        break

if not courses:
    print('No guardians invited for this {0}.'.format(response.get('studentId')))
else:
    print('Guardian Invite:')
    for guardian in guardian_invites:
        print('An invite was sent to '.format(guardian.get('id'),
                                              guardian.get('guardianId')))

Удалить опекунов

Вы также можете удалить опекуна у учащегося, используя метод userProfiles.guardians.delete() :

Ява Питон
класс/фрагменты/src/main/java/DeleteGuardian.java
try {
  service.userProfiles().guardians().delete(studentId, guardianId).execute();
  System.out.printf("The guardian with id %s was deleted.\n", guardianId);
} catch (GoogleJsonResponseException e) {
  GoogleJsonError error = e.getDetails();
  if (error.getCode() == 404) {
    System.out.printf("There is no record of guardianId (%s).", guardianId);
  }
}
service.userProfiles().guardians().delete(studentId='student@mydomain.edu',
                                        guardianId='guardian@gmail.com').execute()
Назад
Создавайте приглашения на курсы и управляйте ими