Method: userProfiles.guardianInvitations.patch

একটি অভিভাবক আমন্ত্রণ পরিবর্তন করে৷

বর্তমানে, একমাত্র বৈধ পরিবর্তন হল PENDING থেকে COMPLETE তে state পরিবর্তন করা। এতে আমন্ত্রণ প্রত্যাহার করার প্রভাব রয়েছে।

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

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

HTTP অনুরোধ

PATCH https://classroom.googleapis.com/v1/userProfiles/{studentId}/guardianInvitations/{invitationId}

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

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

পরামিতি
student Id

string

যে শিক্ষার্থীর অভিভাবক আমন্ত্রণ করেছেন তার আইডি পরিবর্তন করতে হবে।

invitation Id

string

GuardianInvitation id ফিল্ড পরিবর্তন করা হবে।

ক্যোয়ারী প্যারামিটার

পরামিতি
update Mask

string ( FieldMask format)

মাস্ক যা কোর্সের কোন ক্ষেত্রগুলিকে আপডেট করতে হবে তা সনাক্ত করে৷ এই ক্ষেত্রটি একটি আপডেট করতে হবে। অবৈধ ক্ষেত্র নির্দিষ্ট করা থাকলে আপডেট ব্যর্থ হয়। নিম্নলিখিত ক্ষেত্রগুলি বৈধ:

  • state

একটি ক্যোয়ারী প্যারামিটারে সেট করা হলে, এই ক্ষেত্রটি হিসাবে নির্দিষ্ট করা উচিত

updateMask=<field1>,<field2>,...

এটি ক্ষেত্রগুলির সম্পূর্ণরূপে যোগ্য নামের একটি কমা দ্বারা পৃথক করা তালিকা৷ উদাহরণ: "user.displayName,photo"

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

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

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

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

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

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

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

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

,

একটি অভিভাবক আমন্ত্রণ পরিবর্তন করে৷

বর্তমানে, একমাত্র বৈধ পরিবর্তন হল PENDING থেকে COMPLETE তে state পরিবর্তন করা। এতে আমন্ত্রণ প্রত্যাহার করার প্রভাব রয়েছে।

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

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

HTTP অনুরোধ

PATCH https://classroom.googleapis.com/v1/userProfiles/{studentId}/guardianInvitations/{invitationId}

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

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

পরামিতি
student Id

string

যে শিক্ষার্থীর অভিভাবক আমন্ত্রণ করেছেন তার আইডি পরিবর্তন করতে হবে।

invitation Id

string

GuardianInvitation id ফিল্ড পরিবর্তন করা হবে।

ক্যোয়ারী প্যারামিটার

পরামিতি
update Mask

string ( FieldMask format)

মাস্ক যা কোর্সের কোন ক্ষেত্রগুলিকে আপডেট করতে হবে তা সনাক্ত করে৷ এই ক্ষেত্রটি একটি আপডেট করতে হবে। অবৈধ ক্ষেত্র নির্দিষ্ট করা থাকলে আপডেট ব্যর্থ হয়। নিম্নলিখিত ক্ষেত্রগুলি বৈধ:

  • state

একটি ক্যোয়ারী প্যারামিটারে সেট করা হলে, এই ক্ষেত্রটি হিসাবে নির্দিষ্ট করা উচিত

updateMask=<field1>,<field2>,...

এটি ক্ষেত্রগুলির সম্পূর্ণরূপে যোগ্য নামের একটি কমা দ্বারা পৃথক করা তালিকা৷ উদাহরণ: "user.displayName,photo"

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

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

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

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

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

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

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

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