একজন অভিভাবক সংস্থান একজন ব্যবহারকারীকে প্রতিনিধিত্ব করে, যেমন একজন অভিভাবক, যিনি একজন শিক্ষার্থীর কোর্স এবং কাজ সম্পর্কে তথ্য পান। অভিভাবক, যিনি সাধারণত ছাত্রের ক্লাসরুম ডোমেনের সদস্য নন, অভিভাবক হওয়ার জন্য তাদের ইমেল ঠিকানা ব্যবহার করে আমন্ত্রণ জানাতে হবে।
এই আমন্ত্রণটি PENDING
অবস্থায় একটি অভিভাবক আমন্ত্রণ সংস্থান তৈরি করে৷ ব্যবহারকারী তখন একটি ইমেল পান যা তাদের আমন্ত্রণ গ্রহণ করার জন্য অনুরোধ করে। যদি ইমেল ঠিকানাটি একটি Google অ্যাকাউন্টের সাথে যুক্ত না হয়, তবে ব্যবহারকারীকে আমন্ত্রণ গ্রহণ করার আগে একটি তৈরি করতে বলা হয়।
আমন্ত্রণটির একটি PENDING
থাকা অবস্থায়, ব্যবহারকারী আমন্ত্রণটি গ্রহণ করতে পারে, যা একটি অভিভাবক সংস্থান তৈরি করে এবং অভিভাবক আমন্ত্রণটিকে COMPLETED
অবস্থায় চিহ্নিত করে৷ যদি একটি আমন্ত্রণ মেয়াদ শেষ হয়ে যায়, অথবা যদি একজন অনুমোদিত ব্যবহারকারী আমন্ত্রণ বাতিল করে (উদাহরণস্বরূপ, PatchGuardianInvitation
পদ্ধতি ব্যবহার করে) তাহলে এটি COMPLETED
হয়ে যেতে পারে। শ্রেণীকক্ষ ব্যবহারকারী ইন্টারফেস বা DeleteGuardian
পদ্ধতি ব্যবহার করে অভিভাবক, শ্রেণীকক্ষ শিক্ষক বা প্রশাসকের দ্বারা অভিভাবক সম্পর্কও ভেঙে যেতে পারে।
যারা অভিভাবকদের পরিচালনা করতে পারে
নিম্নলিখিত সারণীটি বর্তমানে প্রমাণীকৃত ব্যবহারকারীর ধরন অনুসারে অভিভাবকদের সাথে সম্পাদিত ক্রিয়াগুলি বর্ণনা করে:
স্কোপ
তিনটি সুযোগ রয়েছে যা আপনাকে অভিভাবকদের পরিচালনা করার অনুমতি দেয়:
- 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 আপনাকে অভিভাবক এবং অভিভাবকদের আমন্ত্রণগুলি দেখতে এবং সংশোধন করতে দেয় যা ব্যবহারকারী শেখায় বা পরিচালনা করে।
সাধারণ কর্ম
এই বিভাগটি কিছু সাধারণ অভিভাবক কর্মের বর্ণনা করে যা আপনি Google Classroom API ব্যবহার করে সম্পাদন করতে চাইতে পারেন।
একটি অভিভাবক আমন্ত্রণ তৈরি করুন
নিম্নলিখিত উদাহরণ দেখায় কিভাবে আপনি userProfiles.guardianInvitations.create()
পদ্ধতি ব্যবহার করে একটি অভিভাবক আমন্ত্রণ তৈরি করতে পারেন:
জাভা
পাইথন
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')))
ফলাফলে একটি সার্ভার-অর্পিত শনাক্তকারী রয়েছে যা গার্ডিয়ানআমন্ত্রণে উল্লেখ করতে ব্যবহার করা যেতে পারে।
একটি অভিভাবক আমন্ত্রণ বাতিল করুন
একটি আমন্ত্রণ বাতিল করতে, userProfiles.guardianInvitations.patch()
পদ্ধতিতে কল করে আমন্ত্রণের অবস্থা PENDING
থেকে COMPLETE
পরিবর্তন করুন৷ মনে রাখবেন যে আমন্ত্রণ সরানোর এটিই একমাত্র উপায়।
জাভা
পাইথন
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()
পদ্ধতি ব্যবহার করে একটি নির্দিষ্ট ছাত্রের জন্য পাঠানো সমস্ত আমন্ত্রণের একটি তালিকা পেতে পারেন:
জাভা
পাইথন
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')))
ডিফল্টরূপে, শুধুমাত্র PENDING
আমন্ত্রণগুলি ফেরত দেওয়া হবে৷ একজন ডোমেন প্রশাসক হিসাবে, আপনি একটি স্টেট প্যারামিটার প্রদান করে COMPLETED
অবস্থায় আমন্ত্রণগুলি পুনরুদ্ধার করতে পারেন।
সক্রিয় অভিভাবকদের তালিকা করুন
আপনি যদি নির্ধারণ করতে চান যে কোন ব্যবহারকারীরা একটি নির্দিষ্ট ছাত্রের সক্রিয় অভিভাবক, আপনি userProfiles.guardians.list()
পদ্ধতি ব্যবহার করতে পারেন। সক্রিয় অভিভাবকরা হলেন অভিভাবক যারা ইমেল আমন্ত্রণ গ্রহণ করেছেন।
জাভা
পাইথন
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()
পদ্ধতি ব্যবহার করে একজন শিক্ষার্থীর অভিভাবককেও সরিয়ে দিতে পারেন:
জাভা
পাইথন
service.userProfiles().guardians().delete(studentId='student@mydomain.edu',
guardianId='guardian@gmail.com').execute()