ডিরেক্টরি এপিআই সমস্যা সমাধান করুন

এই পৃষ্ঠায় একজন রিসেলার হিসেবে ডিরেক্টরি এপিআই (Directory API) ব্যবহারের ক্ষেত্রে আপনার সম্মুখীন হতে পারে এমন কিছু সাধারণ সমস্যা বর্ণনা করা হয়েছে।

400:badRequest

মেথডটিতে ভুল প্যারামিটার মান পাস করা হলে এই ত্রুটিটি ঘটে।

users.get মেথড ব্যবহার করার ক্ষেত্রে, userKey প্যারামিটারে পাঠানো মানটি ব্যবহারকারীর প্রাথমিক ইমেল ঠিকানা, বিকল্প ইমেল ঠিকানা বা অনন্য ইউজার আইডি কি না, তা যাচাই করুন।

users.list মেথডটি ব্যবহার করলে, নিম্নলিখিত প্যারামিটারগুলো যাচাই করুন:

• customer প্যারামিটার: শুধুমাত্র গুগল দ্বারা তৈরি করা customerId ব্যবহার করুন। গ্রাহকের আসল ডোমেইন ব্যবহার করবেন না। আমরা এই প্যারামিটারটি ব্যবহার করার পরামর্শ দিই, কারণ যদি কোনো গ্রাহকের সেকেন্ডারি ডোমেইন থাকে, তাহলে domain প্যারামিটার ব্যবহার করলে শুধুমাত্র সেই নির্দিষ্ট ডোমেইনের ইমেল ঠিকানা থাকা ব্যবহারকারীদেরই দেখানো হয়।
• domain প্যারামিটার: শুধুমাত্র গ্রাহকের আসল ডোমেইন ব্যবহার করুন। গুগল দ্বারা তৈরি করা customerId ব্যবহার করবেন না।

403:domainCannotUseApis

এই ত্রুটিটি ঘটে যখন আপনার গ্রাহক অ্যাডমিন এসডিকে এপিআই-তে রিসেলার অ্যাক্সেস নিষ্ক্রিয় করে রাখেন। এই সমস্যাটি সমাধান করতে, আপনার গ্রাহককে অ্যাডমিন এসডিকে এপিআই-তে অ্যাক্সেস পুনরায় সক্রিয় করতে বলুন। আরও তথ্যের জন্য, ‘এপিআই অ্যাক্সেস নিয়ন্ত্রণ’ দেখুন।

আপনি যদি বর্তমান লাইসেন্সপ্রাপ্ত ব্যবহারকারীর সংখ্যা বের করতে গিয়ে এই ত্রুটিটি পান, তাহলে users.list মেথডটি কল করার পরিবর্তে সাবস্ক্রিপশন রিসোর্স থেকে licensedNumberOfSeats ফিল্ডটি ব্যবহার করুন।

403:forbidden

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

এই সমস্যাটি সমাধান করতে, গ্রাহকের রিসেলার মালিকানা যাচাই করার জন্য কল করার আগে customers.get মেথডটি কল করুন অথবা আপনার গ্রাহককে তাদের অ্যাডমিন কনসোলে রিসেলার অ্যাক্সেস পুনরায় চালু করতে বলুন। আরও তথ্যের জন্য, “একজন গ্রাহকের অ্যাডমিন কনসোল অ্যাক্সেস করুন” দেখুন।

403:usageLimits.accessNotConfigured

গুগল ক্লাউড প্রজেক্টে এপিআই (API) সক্রিয় করা না থাকলে এই ত্রুটিটি দেখা দেয়। এই সমস্যাটি সমাধান করতে, গুগল ক্লাউড কনসোলে যান এবং এপিআই (API) সক্রিয় করুন। আরও তথ্যের জন্য, ‘গুগল ওয়ার্কস্পেস এপিআই (Google Workspace APIs) সক্রিয় করুন’ দেখুন।

409:duplicate

এই ত্রুটিটি ঘটে যখন আপনি একজন নতুন ব্যবহারকারী যোগ করার চেষ্টা করেন, কিন্তু গ্রাহকের প্রাথমিক ইমেলটি নিম্নলিখিতগুলির মধ্যে কোনো একটিতে আগে থেকেই বিদ্যমান থাকে:

• বর্তমান গুগল ওয়ার্কস্পেস অ্যাকাউন্ট, যেটিতে আপনি তাদের যুক্ত করার চেষ্টা করছেন।
• গুগলের আরেকটি পণ্য (গুগল ওয়ার্কস্পেস নয়)।

এই সমস্যাটি সমাধান করতে, নিম্নলিখিতগুলি করুন:

1. users.get মেথডটি কল করুন।

   যদি আপনি একটি 200 রেসপন্স পান, তাহলে ব্যবহারকারীটি গ্রাহকের গুগল ওয়ার্কস্পেস অ্যাকাউন্টে আগে থেকেই আছেন। আপনি এই ব্যবহারকারীকে অ্যাকাউন্টে যুক্ত করতে পারবেন না।

   যদি আপনি একটি 403 forbidden রেসপন্স পান, তাহলে হয় প্রাইমারি ইমেল প্যারামিটারে থাকা ডোমেইনটি কোনো রিসেলড কাস্টমার নয়, অথবা প্রাইমারি ইমেলটি পূর্বে গুগলের অন্য কোনো প্রোডাক্টের জন্য ব্যবহৃত হয়েছে এবং এই ইউজারকে সফলভাবে যুক্ত করার আগে কাস্টমারের ডোমেইনটি প্রথমে ভেরিফাই করতে হবে।

2. আপনি যদি গ্রাহকের ডোমেইন যাচাই করতে পারেন, তাহলে নিম্নলিখিত কাজগুলো করুন:

   1. users.insert পদ্ধতি ব্যবহার করে একজন অস্থায়ী অ্যাডমিনিস্ট্রেটর ব্যবহারকারী তৈরি করুন এবং ডোমেইন যাচাইকরণের চূড়ান্ত ধাপ পর্যন্ত প্রোভিশনিং চালিয়ে যান।
   2. ডোমেইন যাচাই করার সময়, webResource.insert কলের রিকোয়েস্ট বডির owners[] প্যারামিটারে অস্থায়ী ব্যবহারকারীদের যোগ করুন। একটি 200 রেসপন্স না পাওয়া পর্যন্ত এই কলটি করতে থাকুন।
   3. ডোমেইনটি যাচাই করার পরে, users.patch অথবা users.update মেথড ব্যবহার করে অস্থায়ী ইউজারনেমটির নাম পরিবর্তন করুন।

3. যদি আপনি গ্রাহকের ডোমেইন যাচাই করতে না পারেন, তাহলে নিম্নলিখিত পদক্ষেপগুলো অনুসরণ করুন:

   1. users.insert মেথড ব্যবহার করে একজন অস্থায়ী অ্যাডমিনিস্ট্রেটর ইউজার তৈরি করুন।
   2. আপনার গ্রাহককে অস্থায়ী ব্যবহারকারী হিসেবে সাইন ইন করতে বলুন এবং অ্যাডমিন কনসোলের মাধ্যমে তাদের ডোমেইন যাচাই করতে বলুন।
   3. ডোমেইনটি যাচাই হয়ে গেলে, গ্রাহক অথবা আপনি অস্থায়ী ইউজারনেমটির নাম পরিবর্তন করতে পারেন। এর জন্য আপনি users.patch অথবা users.update মেথড ব্যবহার করতে পারেন।

412:limitExceeded

আপনার গ্রাহক যখন তাদের সর্বোচ্চ আসন সীমায় পৌঁছে যান, তখন এই ত্রুটিটি ঘটে। এই সমস্যাটি সমাধান করতে, subscriptions.changeSeats পদ্ধতিটি ব্যবহার করুন এবং তাদের সাবস্ক্রিপশন প্ল্যানের উপর নির্ভর করে নিম্নলিখিতগুলি অনুসরণ করুন:

• FLEXIBLE এর জন্য, maximumNumberOfSeats প্যারামিটারটি বৃদ্ধি করুন।
• ANNUAL জন্য, numberOfSeats প্যারামিটারটি বৃদ্ধি করুন।