การจัดการผู้ปกครอง

แหล่งข้อมูลสําหรับผู้ปกครอง เป็นตัวแทนของผู้ใช้ เช่น ผู้ปกครองที่ได้รับข้อมูลเกี่ยวกับหลักสูตรและงานของนักเรียน ผู้ปกครองที่โดยปกติไม่ได้เป็นสมาชิกของโดเมน Classroom ของนักเรียนจะต้องได้รับคําเชิญโดยใช้อีเมลของตนให้เป็นผู้ปกครอง

คําเชิญนี้จะสร้างทรัพยากรเชิญผู้ปกครองโดยมีสถานะ PENDING จากนั้น ผู้ใช้จะได้รับอีเมลแจ้งให้ตอบรับคําเชิญ หากอีเมลไม่ได้เชื่อมโยงกับบัญชี Google ระบบจะแจ้งให้ผู้ใช้สร้างบัญชีก่อนยอมรับคําเชิญ

แม้ว่าคําเชิญจะมีสถานะ PENDING ผู้ใช้อาจยอมรับคําเชิญ หรืออาจกลายเป็น COMPLETED ด้วยหากคําเชิญนั้นหมดอายุ หรือหากผู้ใช้ที่ได้รับอนุญาตยกเลิกคําเชิญ (เช่น โดยใช้วิธี PatchGuardianInvitation) ความสัมพันธ์ระหว่างผู้ปกครองอาจถูกยกเลิกโดยผู้ปกครอง ครูของ Classroom หรือผู้ดูแลระบบ โดยใช้อินเทอร์เฟซผู้ใช้ Classroom หรือเมธอด DeleteGuardian

ผู้ที่มีสิทธิ์จัดการผู้ปกครอง

ตารางต่อไปนี้อธิบายการดําเนินการที่ใช้กับผู้ปกครองได้ตามประเภทของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ในปัจจุบัน

ตาราง ACL ที่เกี่ยวกับผู้ปกครองตามประเภทผู้ใช้

กล้องติดปืน

มี 3 ขอบเขตที่ช่วยให้คุณจัดการผู้ปกครองได้

การทำงานทั่วไป

ส่วนนี้จะอธิบายการดําเนินการทั่วไปบางส่วนที่ผู้ปกครองอาจต้องการทําโดยใช้ Google Classroom API

สร้างคําเชิญสําหรับผู้ปกครอง

ตัวอย่างต่อไปนี้แสดงวิธีการสร้างคําเชิญสําหรับผู้ปกครอง

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

ผลลัพธ์จะมีตัวระบุที่เซิร์ฟเวอร์กําหนดให้ซึ่งใช้อ้างถึงคําเชิญสําหรับผู้ปกครอง

ยกเลิกคําเชิญของผู้ปกครอง

ตัวอย่างต่อไปนี้แสดงวิธียกเลิกคําเชิญหากผู้ใช้สร้างโดยไม่ได้ตั้งใจ

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

แสดงรายการคําเชิญสําหรับนักเรียนคนใดคนหนึ่ง

คุณสามารถดูรายการคําเชิญทั้งหมดที่ส่งถึงนักเรียน ที่ต้องการ

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

โดยค่าเริ่มต้น ระบบจะแสดงเฉพาะคําเชิญที่รอดําเนินการเท่านั้น ในฐานะผู้ดูแลระบบ คุณสามารถเรียกดูคําเชิญที่มีสถานะสมบูรณ์ได้โดยระบุพารามิเตอร์รัฐนั้นๆ

แสดงรายการผู้ปกครองที่ใช้งานอยู่

หากต้องการระบุว่าผู้ใช้รายใดเป็นผู้ปกครองของนักเรียน/นักศึกษาบางคน คุณสามารถใช้วิธีการของ 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')))

นําผู้ปกครองออก

คุณสามารถนําผู้ปกครองออกจากนักเรียนได้โดยใช้วิธี "ลบผู้ปกครอง"

Python

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