Verwenden Ihre Nutzer Classroom mit Google Meet? Weitere Informationen finden Sie unter Apps Script – Kurzanleitung.

Erziehungsberechtigte verwalten

Eine Guardian-Ressource stellt einen Nutzer dar, z. B. einen Elternteil, der Informationen zu den Kursen und Aufgaben eines Schülers erhält. Der Erziehungsberechtigte, der in der Regel kein Mitglied der Classroom-Domain des Schülers ist, muss mit seiner E-Mail-Adresse eingeladen werden, ein Erziehungsberechtigter zu werden.

Diese Einladung erstellt eine GuardianInvitation-Ressource mit dem Status PENDING. Der Nutzer wird daraufhin per E-Mail aufgefordert, die Einladung anzunehmen. Wenn die E-Mail-Adresse nicht mit einem Google-Konto verknüpft ist, wird der Nutzer aufgefordert, ein Konto zu erstellen, bevor er die Einladung annimmt.

Während die Einladung den Status PENDING hat, kann der Nutzer die Einladung annehmen, wodurch eine Guardian-Ressource erstellt und der Guardian-Einladung mit dem Status COMPLETED markiert wird. Eine Einladung kann auch COMPLETED werden, wenn sie abläuft oder ein autorisierter Nutzer die Einladung zurückzieht (z. B. mit der Methode PatchGuardianInvitation). Die Beziehung eines Erziehungsberechtigten kann auch von einem Erziehungsberechtigten, Classroom-Lehrkraft oder einem Administrator über die Classroom-Benutzeroberfläche oder die DeleteGuardian-Methode aufgehoben werden.

Wer kann Erziehungsberechtigte verwalten?

In der folgenden Tabelle werden die Aktionen beschrieben, die in Bezug auf Erziehungsberechtigte für den derzeit authentifizierten Nutzertyp ausgeführt werden können:

Tabelle mit ACLs für Erziehungsberechtigte nach Nutzertyp

Sucher

Es gibt drei Bereiche, in denen Sie Erziehungsberechtigte verwalten können:

Häufige Aktionen

In diesem Abschnitt werden einige der häufigen Aktionen von Erziehungsberechtigten beschrieben, die Sie mit der Google Classroom API ausführen können.

Einladung für Erziehungsberechtigte erstellen

Das folgende Beispiel zeigt, wie Sie eine Einladung für Erziehungsberechtigte erstellen können:

Python

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')))

Das Ergebnis enthält eine vom Server zugewiesene Kennung, mit der auf die Erziehungsberechtigte verwiesen werden kann.

Einladung für Erziehungsberechtigte zurücknehmen

Das folgende Beispiel zeigt, wie Sie eine Einladung zurücknehmen können, wenn Ihr Nutzer eine solche versehentlich erstellt hat:

Python

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()

Einladungen für einen bestimmten Schüler oder Studenten auflisten

Sie können eine Liste aller Einladungen abrufen, die für einen bestimmten Kursteilnehmer gesendet wurden:

Python

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')))

Standardmäßig werden nur ausstehende Einladungen zurückgegeben. Als Domainadministrator können Sie Einladungen auch im Status COMPLETED abrufen, indem Sie einen Parameter für den Status angeben.

Aktive Erziehungsberechtigte auflisten

Mit der Methode "ListGuardians" können Sie ermitteln, welche Nutzer aktive Erziehungsberechtigte für einen bestimmten Schüler sind:

Python

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')))

Erziehungsberechtigte entfernen

Sie können einen Erziehungsberechtigten auch mithilfe der Methode "DeleteGuardian" entfernen:

Python

service.userProfiles().guardians().delete(studentId='student@mydomain.edu',
                                        guardianId='guardian@gmail.com').execute()