অনুরোধ ত্রুটি
একটি Classroom API ত্রুটিতে একটি ত্রুটি কোড থাকতে পারে যা আপনাকে কারণ সনাক্ত করতে এবং ত্রুটিটি সঠিকভাবে পরিচালনা করতে সহায়তা করতে পারে। কোডের উপর নির্ভর করে, আপনি অনুরোধটি আবার চেষ্টা করতে পারেন বা ব্যবহারকারীদের নির্দিষ্ট ব্যবস্থা নিতে নির্দেশ দিতে পারেন।
এই পৃষ্ঠাটি HTTP কোড দ্বারা গোষ্ঠীভুক্ত সম্ভাব্য ত্রুটি কোডের বিবরণ দেয়। ত্রুটি বার্তার কাঠামো সম্পর্কে আরও পড়তে, ত্রুটি বার্তা কাঠামো পড়ুন।
এই পৃষ্ঠাটি HTTP কোড দ্বারা গোষ্ঠীভুক্ত সম্ভাব্য ত্রুটি কোডের বিবরণ দেয়। কোন পদ্ধতি কোন নির্দিষ্ট ত্রুটি কোড প্রদান করে তা নির্ধারণ করতে রেফারেন্স ডকুমেন্টেশন দেখুন।
HTTP 400: FAILED_PRECONDITION
একটি FAILED_PRECONDITION ফেরত দেওয়া হয় যখন ব্যবহারকারী একটি ক্রিয়া করার চেষ্টা করে যার অনুমতি দেওয়া যায় না, কারণ ব্যবহারকারী একটি সীমা বা একটি অ্যাপ্লিকেশন অবস্থা, যেমন CourseNotModifiable । একটি FAILED_PRECONDITION ঠিক করতে, ব্যবহারকারীকে কিছু পদক্ষেপ নিতে নির্দেশ দিন এবং তারপরে আবার চেষ্টা করুন৷ অথবা, কিছু ক্ষেত্রে, আপনি ব্যবহারকারীর পক্ষে অবস্থা ঠিক করতে বিকল্প শেষ পয়েন্ট ব্যবহার করতে পারেন।
মুলতুবি আমন্ত্রণ বিদ্যমান
PendingInvitationExists নির্দেশ করে যে কাউকে ইতিমধ্যেই কোর্সের মালিকানা নিতে আমন্ত্রণ জানানো হয়েছে৷ এই ত্রুটিটি কোর্সের মালিকানা স্থানান্তরের সময় ঘটে যখন একটি স্থানান্তর পূর্বে শুরু হয়েছিল কিন্তু এখনও নতুন মালিক কর্তৃক গৃহীত হয়নি।
কোর্স মেম্বার লিমিটে পৌঁছেছে
CourseMemberLimitReached নির্দেশ করে যে চেষ্টা করা পদক্ষেপটি কোর্সের সদস্যদের সর্বাধিক অনুমোদিত সংখ্যা অতিক্রম করবে। এই কোডটি সাধারণত students.create() দ্বারা ফেরত দেওয়া হয়। আরও তথ্যের জন্য, একটি ক্লাস সহায়তা কেন্দ্র নিবন্ধে ছাত্রদের আমন্ত্রণ জানানোর "ক্লাসের আকার সীমা" বিভাগটি পড়ুন।
সম্ভাব্য পদক্ষেপ : ব্যর্থতার কারণ বর্ণনা করুন এবং ব্যবহারকারীকে অপ্রয়োজনীয় কোর্স সদস্যদের সরিয়ে দেওয়ার পরামর্শ দিন
কোর্স না পরিবর্তনযোগ্য
CourseNotModifiable ইঙ্গিত করে যে প্রাসঙ্গিক কোর্সটি এমন একটি অবস্থায় রয়েছে যা এর বৈশিষ্ট্যগুলিকে সংশোধন করার অনুমতি দেয় না (কোর্স স্টেট ব্যতীত)।
সম্ভাব্য ক্রিয়া : ব্যবহারকারীকে একটি পরিবর্তনযোগ্য কোর্স অবস্থায় কোর্স পরিবর্তন করার জন্য অনুরোধ করুন। অবস্থা পরিবর্তন করতে, courses.patch() ব্যবহার করুন। অন্যান্য বৈশিষ্ট্য পরিবর্তন করে এমন একটি অনুরোধে কোর্সের অবস্থা পরিবর্তন করা যেতে পারে।
কোর্স শিক্ষকের সীমা পৌঁছেছে
CourseTeacherLimitReached নির্দেশ করে যে অনুরোধ করা পদক্ষেপটি কোর্স শিক্ষকদের সর্বাধিক অনুমোদিত সংখ্যা অতিক্রম করবে। এই কোডটি সাধারণত teachers.create() দ্বারা ফেরত দেওয়া হয়। আরও তথ্যের জন্য, ক্লাস হেল্প সেন্টার নিবন্ধে একজন সহ-শিক্ষক যোগ করুন এর "ক্লাস আকারের সীমাবদ্ধতা" বিভাগটি দেখুন।
সম্ভাব্য পদক্ষেপ : ব্যর্থতার কারণ বর্ণনা করুন এবং ব্যবহারকারীকে অপ্রয়োজনীয় কোর্স শিক্ষকদের সরিয়ে দেওয়ার পরামর্শ দিন। আপনার অ্যাপে প্রযোজ্য হলে, আপনি ব্যবহারকারীর পক্ষে শিক্ষকদের তালিকা পরিচালনা করতে শিক্ষক.delete() ব্যবহার করতে পারেন।
UserGroupsMembership LimitReached
UserGroupsMembershipLimitReached নির্দেশ করে যে ব্যবহারকারী ইতিমধ্যেই সর্বাধিক অনুমোদিত সংখ্যক গোষ্ঠীর সদস্য এবং কোনো কোর্সে যোগ দিতে পারবেন না। এই কোডটি সাধারণত students.create() বা teachers.create() দ্বারা ফেরত দেওয়া হয়। আরও তথ্যের জন্য, একটি ক্লাস সহায়তা কেন্দ্র নিবন্ধে ছাত্রদের আমন্ত্রণ জানানোর "ক্লাস আকারের সীমাবদ্ধতা" বিভাগটি দেখুন।
সম্ভাব্য ক্রিয়া : ব্যর্থতার কারণ বর্ণনা করুন এবং ব্যবহারকারীকে এমন কোনো কোর্স ছেড়ে দেওয়ার পরামর্শ দিন যেখানে তারা অংশগ্রহণ করছে না। ব্যবহারকারীর যদি আরও কোর্সে অংশগ্রহণের প্রয়োজন হয় তবে তারা একটি অতিরিক্ত অ্যাকাউন্ট তৈরি করার কথা বিবেচনা করতে পারে। আপনার অ্যাপে প্রযোজ্য হলে, আপনি ব্যবহারকারীর পক্ষে রোস্টারগুলি পরিচালনা করতে students.create() বা teachers.delete() ব্যবহার করতে পারেন।
সংযুক্তি দৃশ্যমান নয়
AttachmentNotVisible নির্দেশ করে যে নির্দিষ্ট করা এক বা একাধিক সংযুক্তি হয় ব্যবহারকারীর কাছে দৃশ্যমান নয়, অনুরোধকৃত প্রকারের নয় বা বিদ্যমান নেই৷ উদাহরণস্বরূপ, ড্রাইভ আইটেমগুলি যেগুলি ব্যবহারকারীর সাথে ভাগ করা হয়নি সেগুলি এই ত্রুটিটি ফিরিয়ে দেবে৷
সম্ভাব্য ক্রিয়া : ব্যর্থতার কারণ বর্ণনা করুন এবং ব্যবহারকারীকে ড্রাইভ ফাইল আইডিগুলির মতো শনাক্তকারীগুলিকে পুনরায় পরীক্ষা করার পরামর্শ দিন, তারা অন্তর্ভুক্ত করেছে৷ এছাড়াও, নিশ্চিত করুন যে সংযুক্তিটি দেখার জন্য ব্যবহারকারীর যথাযথ অনুমতি রয়েছে।
CourseFolderOwner সরাতে পারবেন না
CannotRemoveCourseFolderOwner নির্দেশ করে যে কোর্স ড্রাইভ ফোল্ডারের মালিককে সরানো যাবে না।
সম্ভাব্য ক্রিয়া : ব্যর্থতার কারণ বর্ণনা করুন এবং সুপারিশ করুন যে ব্যবহারকারী কোর্স ড্রাইভ ফোল্ডারের মালিকানা অন্য ব্যবহারকারীর কাছে হস্তান্তর করুন এবং আবার চেষ্টা করুন।
কোর্সের মালিককে সরানো যাবে না
CannotRemoveCourseOwner নির্দেশ করে যে কোর্সের মালিককে সরানো যাবে না।
সম্ভাব্য পদক্ষেপ : ব্যর্থতার কারণ বর্ণনা করুন এবং পরামর্শ দিন যে কোর্সের মালিককে অপসারণ করা যাবে না। বেশিরভাগ ক্ষেত্রে, ব্যবহারকারী নিজেকে অপসারণ করার চেষ্টা করছেন যা অনুমোদিত নয়।
কোর্সের মালিক হস্তান্তর অসম্পূর্ণ সরানো যাবে না৷
CannotRemoveCourseOwnerTransferIncomplete নির্দেশ করে যে কোর্সের মালিককে সরানো যাবে না কারণ এই শ্রেণীর মালিকানা স্থানান্তর এখনও চলছে।
সম্ভাব্য ক্রিয়া : ব্যর্থতার কারণ বর্ণনা করুন এবং ব্যবহারকারীকে ক্লাসের মালিকানা হস্তান্তরের অসিঙ্ক্রোনাস অ্যাকশন সম্পূর্ণ হওয়ার জন্য কয়েক মুহূর্ত অপেক্ষা করার পরামর্শ দিন, তারপর আবার চেষ্টা করুন।
কোন কোর্সের মালিকের সাথে শিক্ষককে সরানো যাবে না৷
CannotRemoveTeacherWithNoCourseOwner নির্দেশ করে যে একজন শিক্ষককে এমন কোর্স থেকে সরানো যাবে না যার মালিক নেই।
সম্ভাব্য পদক্ষেপ : ব্যর্থতার কারণ বর্ণনা করুন এবং পরামর্শ দিন যে শিক্ষককে অপসারণ করা যাবে না। বেশিরভাগ ক্ষেত্রেই, কোর্সের মালিকের ব্যবহারকারীর অ্যাকাউন্ট মুছে ফেলা হয়েছে, যার ফলে একটি অবৈধ কোর্সের অবস্থা।
নিষ্ক্রিয় কোর্সের মালিক
InactiveCourseOwner ইঙ্গিত করে যে অনুরোধ করা পদক্ষেপটি অনুমোদিত নয় কারণ কোর্স মালিকের অ্যাকাউন্ট মুছে ফেলা হয়েছে৷ অনুরোধ করা পদক্ষেপ নেওয়ার আগে কোর্স মালিকের প্রশাসককে কোর্স মালিকের অ্যাকাউন্ট পুনরুদ্ধার করতে হবে।
সম্ভাব্য পদক্ষেপ : ব্যর্থতার কারণ বর্ণনা করুন এবং পরামর্শ দিন যে প্রশাসক অপারেশনটি পুনরায় চেষ্টা করার আগে কোর্স মালিকের অ্যাকাউন্ট পুনরুদ্ধার করুন ৷
অযোগ্য মালিক
IneligibleOwner নির্দেশ করে যে ব্যবহারকারীকে কোর্সের মালিক হিসেবে যোগ করা যাবে না কারণ ব্যবহারকারী একজন সহ-শিক্ষক নয়।
সম্ভাব্য কর্ম : ব্যর্থতার কারণ বর্ণনা করুন। অনুরোধকারী ব্যবহারকারী যদি প্রশাসক না হন, তাহলে মালিককে আপডেট করার আগে তারা প্রথমে ব্যবহারকারীকে কোর্সে শিক্ষক হওয়ার আমন্ত্রণ পাঠান। অনুরোধকারী ব্যবহারকারী যদি একজন প্রশাসক হন, তাহলে তারা প্রথমে ব্যবহারকারীকে কোর্সের সহ-শিক্ষক হিসেবে যোগ করার পরামর্শ দিন।
UserCannotOwnCourse
UserCannotOwnCourse নির্দেশ করে যে ব্যবহারকারীকে কোর্সের মালিক হিসেবে যোগ করা যাবে না।
সম্ভাব্য পদক্ষেপ : ব্যর্থতার কারণ বর্ণনা করুন এবং পরামর্শ দিন যে ব্যবহারকারীর সাথে কোর্সের মালিক হিসাবে কোর্সটি তৈরি করা যাবে না। একজন নন-প্রশাসক অনুরোধকারী ব্যবহারকারী এই ত্রুটিটি দেখতে পারেন যদি তারা মালিক হিসাবে নিজেদের ছাড়া অন্য কোনও ব্যবহারকারীর সাথে একটি কোর্স তৈরি করার চেষ্টা করেন। একজন প্রশাসক অনুরোধকারী ব্যবহারকারী এই ত্রুটিটি দেখতে পারেন যদি মালিক হিসাবে নির্দিষ্ট করা ব্যবহারকারীর অ্যাকাউন্টটি বিদ্যমান না থাকে বা ব্যবহারকারী তাদের ডোমেনে না থাকে।
HTTP 429: RESOURCE_EXHAUSTED
RESOURCE_EXHAUSTED ফেরত দেওয়া হয় যখন অনুরোধ করা অ্যাকশনের অনুমতি না থাকে কারণ কিছু রিসোর্স, যেমন কোটা বা সার্ভারের ক্ষমতা শেষ হয়ে গেছে। এই ধরনের অনুরোধ ত্রুটিগুলি সাধারণত ঘটে কারণ আপনার অ্যাপটি অতিরিক্ত লোড তৈরি করেছে৷
এই সীমাগুলিকে ট্রিগার করা এড়াতে এবং আপনার অ্যাপ্লিকেশনের নির্ভরযোগ্যতা বাড়াতে, পুনরায় চেষ্টা করার পদ্ধতি ব্যবহার করুন। বৈধ পুনঃপ্রচেষ্টা প্রক্রিয়া অন্তর্ভুক্ত:
অনুরোধটি পুনরায় চেষ্টা করতে এবং সমসাময়িক পরিবেশে অনুরোধের থ্রুপুট সর্বাধিক করার জন্য কাটা সূচকীয় ব্যাকঅফ ব্যবহার করুন।
সংঘর্ষ এড়াতে, জিটারের সাথে কাটা সূচকীয় ব্যাকঅফ বিবেচনা করুন। জিটার প্রবর্তন করা আপনার অনুরোধগুলিকে দ্রুত সফল হতে সাহায্য করতে পারে একটি এলোমেলো বিলম্ব প্রবর্তন করে যা অনুরোধে স্পাইক ছড়িয়ে দেয়।
যদি আপনার আবেদন কোটা সীমাবদ্ধতার কারণে RESOURCE_EXHAUSTED ত্রুটি ফেরত দেয়, তাহলে কোটা বৃদ্ধি জমা দিন। আরও তথ্যের জন্য, মনিটর API কোটা সহায়তা কেন্দ্র নিবন্ধটি পড়ুন।
UserCourseJoinRate LimitReached
UserCourseJoinRateLimitReached নির্দেশ করে যে ব্যবহারকারী ইতিমধ্যে একদিনে সর্বাধিক অনুমোদিত সংখ্যক কোর্সে যোগদান করেছেন। আরও তথ্যের জন্য, আন্ডারস্ট্যান্ড গ্রুপের নীতি এবং সীমা সহায়তা কেন্দ্র নিবন্ধের "গ্রুপ আমন্ত্রণ এবং আকার" বিভাগটি পড়ুন।
সম্ভাব্য পদক্ষেপ : ব্যর্থতার কারণ বর্ণনা করুন এবং পরামর্শ দিন যে ব্যবহারকারী কোর্সে যোগদানের আগে একদিন অপেক্ষা করুন।
HTTP 500: INTERNAL
INTERNAL নির্দেশ করে যে অনুরোধটি প্রক্রিয়া করার সময় একটি অপ্রত্যাশিত ত্রুটি দেখা দিয়েছে৷ INTERNAL অনুরোধ ত্রুটিগুলিও প্রায়শই অনুরোধটি পুনরায় চেষ্টা করার জন্য সূচকীয় ব্যাকঅফ ব্যবহার করে সমাধান করা যেতে পারে। যদি একটি INTERNAL ত্রুটি থেকে যায়, এটি Classroom API পাবলিক ইস্যু ট্র্যাকারে একটি বাগ ফাইল করে রিপোর্ট করা যেতে পারে।