একটি অভিভাবক আমন্ত্রণ তৈরি করে, এবং অভিভাবককে একটি ইমেল পাঠায় যাতে তারা নিশ্চিত করতে বলে যে তারা শিক্ষার্থীর অভিভাবক।
অভিভাবক একবার আমন্ত্রণ গ্রহণ করলে, তাদের 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 | ছাত্রের আইডি (স্ট্যান্ডার্ড ফর্ম্যাটে) |
শরীরের অনুরোধ
অনুরোধের মূল অংশে 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 | ছাত্রের আইডি (স্ট্যান্ডার্ড ফর্ম্যাটে) |
শরীরের অনুরোধ
অনুরোধের মূল অংশে GuardianInvitation
একটি উদাহরণ রয়েছে।
প্রতিক্রিয়া শরীর
সফল হলে, রেসপন্স বডিতে GuardianInvitation
একটি নতুন তৈরি উদাহরণ থাকে।
অনুমোদনের সুযোগ
নিম্নলিখিত OAuth সুযোগ প্রয়োজন:
-
https://www.googleapis.com/auth/classroom.guardianlinks.students
আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।