Method: userProfiles.guardianInvitations.create

একটি অভিভাবক আমন্ত্রণ তৈরি করে, এবং অভিভাবককে একটি ইমেল পাঠায় যাতে তারা নিশ্চিত করতে বলে যে তারা শিক্ষার্থীর অভিভাবক।

অভিভাবক একবার আমন্ত্রণ গ্রহণ করলে, তাদের state COMPLETED হয়ে যাবে এবং তারা অভিভাবকদের বিজ্ঞপ্তি পেতে শুরু করবে। সক্রিয় অভিভাবকের প্রতিনিধিত্ব করার জন্য একটি Guardian সংস্থানও তৈরি করা হবে।

রিকোয়েস্ট অবজেক্টে studentId এবং invitedEmailAddress ফিল্ড সেট থাকতে হবে। এই ক্ষেত্রগুলি সেট করতে বা অনুরোধে অন্য কোনও ক্ষেত্র সেট করতে ব্যর্থ হলে একটি ত্রুটি দেখা দেবে৷

এই পদ্ধতি নিম্নলিখিত ত্রুটি কোড প্রদান করে:

  • PERMISSION_DENIED যদি বর্তমান ব্যবহারকারীর অভিভাবকদের পরিচালনা করার অনুমতি না থাকে, যদি প্রশ্নরত অভিভাবক ইতিমধ্যেই সেই শিক্ষার্থীর জন্য অনেক অনুরোধ প্রত্যাখ্যান করে থাকেন, যদি অভিভাবকরা প্রশ্নে থাকা ডোমেনের জন্য সক্ষম না থাকে, বা অন্যান্য অ্যাক্সেস ত্রুটির জন্য।
  • RESOURCE_EXHAUSTED যদি শিক্ষার্থী বা অভিভাবক অভিভাবক লিঙ্কের সীমা অতিক্রম করে থাকেন।
  • INVALID_ARGUMENT যদি অভিভাবকের ইমেল ঠিকানাটি বৈধ না হয় (উদাহরণস্বরূপ, যদি এটি খুব দীর্ঘ হয়), বা যদি প্রদত্ত ছাত্র আইডির বিন্যাসটি স্বীকৃত না হয় (এটি একটি ইমেল ঠিকানা নয়, বা এই API থেকে একটি userId নয়)৷ শুধুমাত্র পঠনযোগ্য ক্ষেত্রগুলি সেট করা থাকলে, বা যদি state ক্ষেত্রটি PENDING ছাড়া অন্য কোনো মানতে সেট করা হয় তবে এই ত্রুটিটিও ফেরত দেওয়া হবে।
  • NOT_FOUND যদি প্রদত্ত ছাত্র আইডি একটি বৈধ ছাত্র আইডি হয়, কিন্তু ক্লাসরুমে সেই ছাত্রের কোনো রেকর্ড নেই৷
  • ALREADY_EXISTS invitedEmailAddress invitedEmailAddress Guardian

HTTP অনুরোধ

POST https://classroom.googleapis.com/v1/userProfiles/{guardianInvitation.studentId}/guardianInvitations

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
guardian Invitation. student Id

string

ছাত্রের আইডি (স্ট্যান্ডার্ড ফর্ম্যাটে)

শরীরের অনুরোধ

অনুরোধের মূল অংশে GuardianInvitation একটি উদাহরণ রয়েছে।

প্রতিক্রিয়া শরীর

সফল হলে, রেসপন্স বডিতে GuardianInvitation একটি নতুন তৈরি উদাহরণ থাকে।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/classroom.guardianlinks.students

আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।

,

একটি অভিভাবক আমন্ত্রণ তৈরি করে, এবং অভিভাবককে একটি ইমেল পাঠায় যাতে তারা নিশ্চিত করতে বলে যে তারা শিক্ষার্থীর অভিভাবক।

অভিভাবক একবার আমন্ত্রণ গ্রহণ করলে, তাদের state COMPLETED হয়ে যাবে এবং তারা অভিভাবকদের বিজ্ঞপ্তি পেতে শুরু করবে। সক্রিয় অভিভাবকের প্রতিনিধিত্ব করার জন্য একটি Guardian সংস্থানও তৈরি করা হবে।

রিকোয়েস্ট অবজেক্টে studentId এবং invitedEmailAddress ফিল্ড সেট থাকতে হবে। এই ক্ষেত্রগুলি সেট করতে বা অনুরোধে অন্য কোনও ক্ষেত্র সেট করতে ব্যর্থ হলে একটি ত্রুটি দেখা দেবে৷

এই পদ্ধতি নিম্নলিখিত ত্রুটি কোড প্রদান করে:

  • PERMISSION_DENIED যদি বর্তমান ব্যবহারকারীর অভিভাবকদের পরিচালনা করার অনুমতি না থাকে, যদি প্রশ্নরত অভিভাবক ইতিমধ্যেই সেই শিক্ষার্থীর জন্য অনেক অনুরোধ প্রত্যাখ্যান করে থাকেন, যদি অভিভাবকরা প্রশ্নে থাকা ডোমেনের জন্য সক্ষম না থাকে, বা অন্যান্য অ্যাক্সেস ত্রুটির জন্য।
  • RESOURCE_EXHAUSTED যদি শিক্ষার্থী বা অভিভাবক অভিভাবক লিঙ্কের সীমা অতিক্রম করে থাকেন।
  • INVALID_ARGUMENT যদি অভিভাবকের ইমেল ঠিকানাটি বৈধ না হয় (উদাহরণস্বরূপ, যদি এটি খুব দীর্ঘ হয়), বা যদি প্রদত্ত ছাত্র আইডির বিন্যাসটি স্বীকৃত না হয় (এটি একটি ইমেল ঠিকানা নয়, বা এই API থেকে একটি userId নয়)৷ শুধুমাত্র পঠনযোগ্য ক্ষেত্রগুলি সেট করা থাকলে, বা যদি state ক্ষেত্রটি PENDING ছাড়া অন্য কোনো মানতে সেট করা হয় তবে এই ত্রুটিটিও ফেরত দেওয়া হবে।
  • NOT_FOUND যদি প্রদত্ত ছাত্র আইডি একটি বৈধ ছাত্র আইডি হয়, কিন্তু ক্লাসরুমে সেই ছাত্রের কোনো রেকর্ড নেই৷
  • ALREADY_EXISTS invitedEmailAddress invitedEmailAddress Guardian

HTTP অনুরোধ

POST https://classroom.googleapis.com/v1/userProfiles/{guardianInvitation.studentId}/guardianInvitations

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
guardian Invitation. student Id

string

ছাত্রের আইডি (স্ট্যান্ডার্ড ফর্ম্যাটে)

শরীরের অনুরোধ

অনুরোধের মূল অংশে GuardianInvitation একটি উদাহরণ রয়েছে।

প্রতিক্রিয়া শরীর

সফল হলে, রেসপন্স বডিতে GuardianInvitation একটি নতুন তৈরি উদাহরণ থাকে।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/classroom.guardianlinks.students

আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।