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