Người dùng của bạn có đang sử dụng Lớp học với Google Meet không? Hãy tham khảo bài viết hướng dẫn nhanh về Apps Script để biết cách điểm danh học viên trong các khóa học của Google Meet.

Quản lý người giám hộ

Tài nguyên dành cho người giám hộ đại diện cho người dùng, chẳng hạn như cha mẹ, người nhận thông tin về các khóa học và bài tập của học viên. Người giám hộ, thường là thành viên của miền Lớp học của học viên, phải được mời bằng địa chỉ email của mình để trở thành người giám hộ.

Lời mời này sẽ tạo tài nguyên GuardianInvitation với trạng thái là PENDING. Sau đó, người dùng sẽ nhận được email nhắc họ chấp nhận lời mời. Nếu địa chỉ email chưa liên kết với Tài khoản Google, người dùng sẽ được nhắc tạo một tài khoản trước khi chấp nhận lời mời.

Mặc dù lời mời có trạng thái là PENDING, nhưng người dùng có thể chấp nhận lời mời, việc này sẽ tạo tài nguyên cho người giám hộ và đánh dấu trạng thái là GuardianInvitation bằng trạng thái COMPLETED. Lời mời cũng có thể trở thành COMPLETED nếu lời mời đó hết hạn hoặc người dùng được ủy quyền hủy lời mời (ví dụ: bằng cách sử dụng phương thức PatchGuardianInvitation). Mối quan hệ người giám hộ cũng có thể bị chấm dứt bởi một người giám hộ, giáo viên hoặc quản trị viên Lớp học, thông qua giao diện người dùng của Lớp học hoặc phương thức DeleteGuardian.

Người có thể quản lý người giám hộ

Bảng sau đây mô tả các thao tác có thể thực hiện đối với người giám hộ, theo kiểu người dùng hiện đã được xác thực:

Bảng các ACL liên quan đến người giám hộ theo loại người dùng

Kính ngắm

Có ba phạm vi cho phép bạn quản lý người giám hộ:

Tác vụ thông thường

Phần này mô tả một số thao tác phổ biến mà người giám hộ mà bạn có thể muốn thực hiện bằng API Google Lớp học.

Tạo lời mời dành cho người giám hộ

Ví dụ sau đây minh họa cách tạo lời mời dành cho người giám hộ:

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

Kết quả bao gồm một giá trị nhận dạng do máy chủ chỉ định. Giá trị này có thể được dùng để tham chiếu đến GuardianInvitation.

Hủy lời mời dành cho người giám hộ

Ví dụ sau đây cho biết cách hủy lời mời nếu người dùng của bạn tạo nhầm lời mời:

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

Liệt kê lời mời dành cho một học viên cụ thể

Bạn có thể xem danh sách tất cả lời mời đã được gửi cho một học viên cụ thể:

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

Theo mặc định, hệ thống chỉ trả về những lời mời ĐANG CHỜ XỬ LÝ. Là quản trị viên miền, bạn cũng có thể truy xuất các lời mời ở trạng thái COMPLETE bằng cách cung cấp thông số trạng thái.

Liệt kê người giám hộ đang hoạt động

Nếu muốn xác định người dùng nào là người giám hộ đang hoạt động cho một học viên cụ thể, bạn có thể sử dụng phương thức ListGuardians:

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

Loại bỏ người giám hộ

Bạn cũng có thể xóa người giám hộ khỏi học viên bằng cách sử dụng phương thức DeleteGuardian:

Python

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