অভিভাবকদের ব্যবস্থাপনা

একজন অভিভাবক সংস্থান একজন ব্যবহারকারীকে প্রতিনিধিত্ব করে, যেমন একজন অভিভাবক, যিনি একজন শিক্ষার্থীর কোর্স এবং কাজ সম্পর্কে তথ্য পান। অভিভাবক, যিনি সাধারণত ছাত্রের ক্লাসরুম ডোমেনের সদস্য নন, অভিভাবক হওয়ার জন্য তাদের ইমেল ঠিকানা ব্যবহার করে আমন্ত্রণ জানাতে হবে।

এই আমন্ত্রণটি PENDING অবস্থায় একটি অভিভাবক আমন্ত্রণ সংস্থান তৈরি করে৷ ব্যবহারকারী তখন একটি ইমেল পান যা তাদের আমন্ত্রণ গ্রহণ করার জন্য অনুরোধ করে। যদি ইমেল ঠিকানাটি একটি Google অ্যাকাউন্টের সাথে যুক্ত না হয়, তবে ব্যবহারকারীকে আমন্ত্রণ গ্রহণ করার আগে একটি তৈরি করতে বলা হয়।

আমন্ত্রণটির একটি PENDING থাকা অবস্থায়, ব্যবহারকারী আমন্ত্রণটি গ্রহণ করতে পারে, যা একটি অভিভাবক সংস্থান তৈরি করে এবং অভিভাবক আমন্ত্রণটিকে COMPLETED অবস্থায় চিহ্নিত করে৷ যদি একটি আমন্ত্রণ মেয়াদ শেষ হয়ে যায়, অথবা যদি একজন অনুমোদিত ব্যবহারকারী আমন্ত্রণ বাতিল করে (উদাহরণস্বরূপ, PatchGuardianInvitation পদ্ধতি ব্যবহার করে) তাহলে এটি COMPLETED হয়ে যেতে পারে। শ্রেণীকক্ষ ব্যবহারকারী ইন্টারফেস বা DeleteGuardian পদ্ধতি ব্যবহার করে অভিভাবক, শ্রেণীকক্ষ শিক্ষক বা প্রশাসকের দ্বারা অভিভাবক সম্পর্কও ভেঙে যেতে পারে।

যারা অভিভাবকদের পরিচালনা করতে পারে

নিম্নলিখিত সারণীটি বর্তমানে প্রমাণীকৃত ব্যবহারকারীর ধরন অনুসারে অভিভাবকদের সাথে সম্পাদিত ক্রিয়াগুলি বর্ণনা করে:

ব্যবহারকারীর ধরন অনুসারে অভিভাবক-সম্পর্কিত ACL-এর সারণী

স্কোপ

তিনটি সুযোগ রয়েছে যা আপনাকে অভিভাবকদের পরিচালনা করার অনুমতি দেয়:

সাধারণ কর্ম

এই বিভাগটি কিছু সাধারণ অভিভাবক কর্মের বর্ণনা করে যা আপনি Google Classroom API ব্যবহার করে সম্পাদন করতে চাইতে পারেন।

একটি অভিভাবক আমন্ত্রণ তৈরি করুন

নিম্নলিখিত উদাহরণ দেখায় কিভাবে আপনি userProfiles.guardianInvitations.create() পদ্ধতি ব্যবহার করে একটি অভিভাবক আমন্ত্রণ তৈরি করতে পারেন:

জাভা

classroom/snippets/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')))

ফলাফলে একটি সার্ভার-অর্পিত শনাক্তকারী রয়েছে যা গার্ডিয়ানআমন্ত্রণে উল্লেখ করতে ব্যবহার করা যেতে পারে।

একটি অভিভাবক আমন্ত্রণ বাতিল করুন

একটি আমন্ত্রণ বাতিল করতে, userProfiles.guardianInvitations.patch() পদ্ধতিতে কল করে আমন্ত্রণের অবস্থা PENDING থেকে COMPLETE পরিবর্তন করুন৷ মনে রাখবেন যে আমন্ত্রণ সরানোর এটিই একমাত্র উপায়।

জাভা

classroom/snippets/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() পদ্ধতি ব্যবহার করে একটি নির্দিষ্ট ছাত্রের জন্য পাঠানো সমস্ত আমন্ত্রণের একটি তালিকা পেতে পারেন:

জাভা

classroom/snippets/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')))

ডিফল্টরূপে, শুধুমাত্র PENDING আমন্ত্রণগুলি ফেরত দেওয়া হবে৷ একজন ডোমেন প্রশাসক হিসাবে, আপনি একটি স্টেট প্যারামিটার প্রদান করে COMPLETED অবস্থায় আমন্ত্রণগুলি পুনরুদ্ধার করতে পারেন।

সক্রিয় অভিভাবকদের তালিকা করুন

আপনি যদি নির্ধারণ করতে চান যে কোন ব্যবহারকারীরা একটি নির্দিষ্ট ছাত্রের সক্রিয় অভিভাবক, আপনি userProfiles.guardians.list() পদ্ধতি ব্যবহার করতে পারেন। সক্রিয় অভিভাবকরা হলেন অভিভাবক যারা ইমেল আমন্ত্রণ গ্রহণ করেছেন।

জাভা

classroom/snippets/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() পদ্ধতি ব্যবহার করে একজন শিক্ষার্থীর অভিভাবককেও সরিয়ে দিতে পারেন:

জাভা

classroom/snippets/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()